标签: #AST

AST 提参数类型和默认值，比纯文本注释准在哪：三种生成函数文档方式的对比

AST 提取签名信息配合注释解析是生成准确 API 文档的最优方案：类型和默认值从 AST 直接获取，准确率 100%，描述文字从 docstring 匹配。纯文本正则解析在处理复杂默认值时准确率骤降，纯 AST 生成则缺少描述信息。推荐使用 `ast` 模块加 `docstring_parser` 库实现，约 100-150 行代码即可稳定运行。