直接用 ast.walk 容易漏节点，因其深度优先且仅遍历非 nil 子节点，不处理 type alias 等新字段，也不提供上下文；需手写递归下降并显式访问各结构字段。
为什么直接用 ast.Walk 容易漏节点
因为 ast.Walk 是深度优先、只遍历子节点的通用遍历器，它不会自动进入字段值为 nil 的节点，也不会处理 Go 1.21+ 新增的某些语法结构（比如 type alias 的 ast.TypeSpec.Alias 字段），更不会告诉你当前节点在 AST 中的上下文位置。你写个空的 ast.Visitor，很可能连函数体里的 return 语句都收不到——它被包在 ast.BlockStmt 里，而你没显式递归访问 BlockStmt.List。
真正可控的方式是手写递归下降：对每个感兴趣的节点类型做 switch，显式调用处理逻辑，并在需要时手动递归到子字段。
- 函数体要自己进
FuncDecl.Body.List遍历语句列表 - 结构体字段要自己看
StructType.Fields.List - 接口方法要自己查
InterfaceType.Methods.List - 别依赖
ast.Inspect的“自动跳过 nil”行为——它省事，也藏 bug
如何识别并安全访问 ast.Node 的具体类型
Go 的 AST 节点都是接口 ast.Node，但实际类型多达上百种。硬写 if n, ok := node.(*ast.CallExpr); ok { ... } 不现实，也难维护。推荐用 go/ast 自带的类型断言组合 + 类型 switch：
func visitNode(n ast.Node) {
switch x := n.(type) {
case *ast.FuncDecl:
fmt.Printf("func %s\n", x.Name.Name)
if x.Body != nil {
ast.Inspect(x.Body, visitNode) // 进入函数体
}
case *ast.CallExpr:
if ident, ok := x.Fun.(*ast.Ident); ok {
fmt.Printf("call %s\n", ident.Name)
}
case *ast.BasicLit:
if x.Kind == token.STRING {
fmt.Printf("string literal: %s\n", x.Value)
}
}
}
注意：不要对所有节点都做递归（比如 *ast.Ident 就没子节点），否则会 panic；ast.Inspect 内部已帮你跳过 nil 子节点，但你自己手写递归时必须判空。
ast.Print 和 ast.Inspect 各自适合什么场景
ast.Print 是调试专用，输出人类可读的树形结构，不返回任何值，不能中断或过滤。它底层调用的是 ast.Fprint，走的是格式化打印路径，和遍历逻辑无关。
ast.Inspect 才是真正的遍历入口，它接受一个函数，按深度优先顺序把每个非-nil 节点传进来，并允许你返回 bool 控制是否继续向下——返回 false 就跳过该节点的所有子节点：
- 想快速看 AST 结构？用
ast.Print(fset, node) - 想提取所有
http.HandleFunc调用？用ast.Inspect+ 类型判断 - 想改写某个函数体？用自定义递归 + 修改节点指针（注意深拷贝问题）
- 想统计某类节点数量？用
ast.Inspect累加计数器即可，不用自己递归
别混淆二者用途：ast.Print 不触发回调，ast.Inspect 不输出文本。
常见陷阱：没传 *token.FileSet 导致位置信息为空
几乎所有 AST 操作（包括 parser.ParseFile、ast.Print、甚至部分 ast.Inspect 中的位置判断）都依赖 *token.FileSet。如果创建时没传，所有 node.Pos() 返回的都是 token.NoPos，你无法定位代码位置、无法生成准确的 diagnostic 信息、也无法做基于行号的过滤。
正确做法：
fset := token.NewFileSet()
f, err := parser.ParseFile(fset, "main.go", src, 0)
if err != nil {
log.Fatal(err)
}
// 后续所有位置相关操作都靠 fset.Position(f.Pos()) 获取行号
还有个隐藏坑：同一个 *token.FileSet 可以复用解析多个文件，但不能跨 goroutine 并发修改（虽然 FileSet.AddFile 是线程安全的，但内部 map 操作不是完全并发安全）。单次分析任务用一个就够了，别每次 new 一个。
AST 遍历本身不难，难的是搞清每个节点的字段含义、什么时候该递归、什么时候该判空、以及位置信息怎么链回源码——这些细节不踩一遍，写出来的工具要么漏报，要么 panic。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
