直接用ast.ParseFile会漏掉import和类型别名，因其不展开import符号、不解析类型底层结构，需配合go/types包做类型检查，并传parser.AllErrors标志确保错误不静默。
为什么直接用 ast.ParseFile 会漏掉 import 和类型别名？
因为 Go 的 AST 解析默认不展开 import 的符号，也不解析类型定义的底层结构。比如你写 type MyInt int，ast.TypeSpec 节点里 Type 字段只是个 *ast.Ident，不是 *ast.BasicLit 或 *ast.SelectorExpr —— 它没做语义绑定。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 必须传
parser.AllErrors标志，否则语法错误会静默跳过 - 若需类型信息（如判断
MyInt底层是int），得配合go/types包做一次完整的类型检查，单靠ast不行 -
ast.ImportSpec的Name字段可能是nil（无别名）或&ast.Ident{Name: "_"}（匿名导入），别直接取Name.Name
怎么安全遍历所有函数声明并提取参数名和类型？
直接递归访问 ast.File 的 Decls 列表，再对每个 *ast.FuncDecl 的 Type.Params.List 做解构即可。但要注意：参数列表里可能有省略号（...）、嵌套括号、甚至空参数（func() {}）。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用
ast.Inspect比手写递归更稳，它自动跳过 nil 节点，且能中断遍历 - 每个
*ast.Field对应一个参数组（支持多参数同类型写法，如a, b, c int），要遍历Names切片 -
Field.Type可能是*ast.Ident、*ast.StarExpr（指针）、*ast.ArrayType等，打印前先做类型断言或用ast.Print辅助调试 - 不要假设
FuncDecl.Recv一定非 nil —— 方法才有接收者，普通函数没有
ast.Walk 和 ast.Inspect 选哪个？
ast.Inspect 更适合分析类工具；ast.Walk 是底层遍历器，需要自己维护状态，容易出错。
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
-
ast.Inspect回调函数返回bool：返回false表示跳过子树（比如只分析顶层函数，不进函数体内部） - 如果要在遍历中收集多个节点（如所有
if语句 + 所有for循环），用闭包变量比传参更直观 - 避免在
Inspect回调里修改 AST 节点 —— 它设计为只读；真要改，用ast.Copy后再操作副本 -
ast.Walk仅当你需要精确控制访问顺序或实现自定义 Visitor 接口时才用，日常分析没必要
为什么修改后的 AST 生成代码格式丑、缺换行？
ast 包本身不带格式化逻辑。它只保证语法正确，不关心缩进、空格、行尾是否换行。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用
gofmt命令行重写文件：gofmt -w file.go - 代码生成阶段用
format.Node+printer.Config控制输出（例如设置Mode: printer.UseSpaces | printer.TabWidth） - 别依赖
ast.Print输出可读代码 —— 它是调试用的，输出含位置信息和冗余括号 - 若做代码重写（如注入日志），注意原 AST 中的
Comments字段不会自动关联到新节点，得手动搬运ast.CommentGroup
真正难的不是构建 AST，而是决定分析边界：要不要跨文件？是否处理 vendor？如何应对泛型类型参数？这些没法靠 ast 自动解决，得在工具启动前就定好策略。
