直接用 ast.ParseFile 会漏掉注释和位置信息，因默认不启用 parser.ParseComments 且需非 nil *token.FileSet；提取函数签名须用 ast.Inspect 处理 FuncDecl.Recv 和 nil 字段；ast.Inspect 比 ast.Walk 更适合局部结构提取；解析失败多因语法错误或非法源码格式。
为什么直接用 ast.ParseFile 会漏掉注释和位置信息
Go 的标准 ast 包默认丢弃注释，且 ast.File 中的 Comments 字段为空——这不是 bug，而是设计选择。真正保留注释需要显式启用 parser.ParseComments 模式，并配合 token.FileSet 才能准确定位每行每列。
- 必须传入非 nil 的
*token.FileSet，否则所有Pos都是 0，无法映射回源码位置 -
parser.ParseComments是 flag，不是默认行为，漏掉它就等于没解析注释 - 注释节点类型是
*ast.CommentGroup，挂在ast.File.Comments和各语法节点的Doc/Comment字段上，不是独立 AST 节点
如何安全遍历 AST 并提取函数签名（含接收者）
用 ast.Inspect 遍历时，不能只看 *ast.FuncDecl，因为方法声明（带接收者）和函数声明结构不同；同时要避免 panic：某些字段（如 Recv、Doc）可能为 nil。
-
FuncDecl.Recv是*ast.FieldList，仅当是方法时非 nil；取接收者类型需递归展开Recv.List[0].Type - 函数名在
FuncDecl.Name.Name，但匿名函数的Name是空字符串，得靠上下文判断 - 用
ast.Print调试时记得传fileSet，否则输出全是???
func visitFuncs(fset *token.FileSet, f *ast.File) {
ast.Inspect(f, func(n ast.Node) bool {
if fd, ok := n.(*ast.FuncDecl); ok {
name := fd.Name.Name
if fd.Recv != nil && len(fd.Recv.List) > 0 {
// 方法：解析接收者类型，比如 *T 或 []int
recvType := fd.Recv.List[0].Type
fmt.Printf("method %s on %s\n", name, ast.Print(fset, recvType))
} else {
fmt.Printf("func %s\n", name)
}
}
return true
})
}
为什么 ast.Walk 不适合做局部结构提取
ast.Walk 是深度优先同步遍历，无法中途退出或跳过子树；而实际场景中，你往往只想找某个函数体里的变量声明，或某 struct 字段列表——这时候 ast.Inspect 的布尔返回值控制更直接。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
-
ast.Walk的 visitor 必须实现全部方法（Visit），哪怕只关心*ast.AssignStmt，也得写空分支 -
ast.Inspect允许返回false跳过当前节点的子树，比如已找到目标函数，就不必再钻进它的 body - 想提取嵌套结构（如 struct 内的字段类型），用
Inspect+ 闭包捕获状态比维护 visitor state 更轻量
解析失败时常见错误信息及应对
最常遇到的是 syntax error: unexpected <code>xxx 或 expected ';'，本质是 parser 在 token 层就卡住了，AST 根本没建出来。这类问题和语法树无关，属于前置校验失败。
立即学习“go语言免费学习笔记（深入）”；
- 确保文件以
.go结尾，且内容是合法 Go 代码（不能是片段，如单独一个func foo()缺少包声明） - 若解析生成代码（如 go:generate 输出），注意 BOM、不可见 Unicode 字符、Windows 换行符都可能导致
token.Position错乱 - 用
parser.Mode & parser.AllErrors可获取多个错误，但需手动遍历err.(scanner.ErrorList)提取详情
AST 解析不是黑盒；位置信息、注释、接收者类型这些关键细节，全依赖初始化时那几行 flag 和 fileSet 的设置。少一个，后续所有分析都可能偏移或静默失败。
