ast.Walk 不适合编译器前端，因其单向、无状态、不可中断且不返回节点，无法支持符号收集、错误报告或AST重写；应改用支持返回新节点的 astutil.Apply 或可中断的 ast.Inspect。
为什么 Go 的 ast.Walk 不适合写编译器前端？
因为 ast.Walk 是单向、无状态、不可中断的遍历，它不返回值，也不允许你修改节点或提前退出。编译器前端需要边遍历边收集符号、报告错误、重写 AST（比如宏展开或类型推导），而 ast.Walk 强制你用闭包捕获外部变量来“模拟”状态，容易出竞态、难测试、无法组合。
常见错误现象：ast.Walk 中试图在 Visit 里修改子节点，结果毫无效果；或者想在遇到某个 func 声明时立即停止遍历，却发现没有返回机制，只能靠 panic（不推荐）或设全局标志（破坏可重入性）。
- 真正需要的是能返回新节点的访问函数，比如
Visit(node ast.Node) ast.Node - Go 标准库没提供这种 API，但
golang.org/x/tools/go/ast/astutil里的Apply支持替换和跳过 - 自定义访问器时，务必让每个 Visit 方法显式返回
ast.Node或nil（表示删除），别依赖副作用
如何用 ast.Inspect 安全地提取函数签名？
ast.Inspect 比 ast.Walk 灵活，它允许你在遍历时返回 false 提前终止，且不强制修改原树。但它仍不返回节点，所以提取签名时重点不是“改”，而是“识别+缓存”。
使用场景：静态分析工具检查所有导出函数是否带文档、参数命名是否符合规范、是否有未使用的接收者等。
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 只在
*ast.FuncDecl节点上做判断，别在*ast.FieldList里重复解析参数名——FuncDecl.Type.Params.List已是结构化结果 - 注意
FuncDecl.Recv可能为nil（函数非方法），直接取Recv.List[0].Type会 panic - 接收者类型如果是
*ast.StarExpr，说明是指针接收者；但ast.Expr类型不保证可直接转成字符串，建议用go/format.Node格式化输出
go/parser 解析失败却没报具体位置？
默认用 go/parser.ParseFile 时，如果文件有语法错误，它只返回 nil, err，而 err 往往是 "syntax error" 这种泛化信息，根本不知道错在哪行哪列。
根本原因是没传入 *token.FileSet，导致错误无法定位。标准做法是显式创建并传入：
fs := token.NewFileSet()
f, err := parser.ParseFile(fs, filename, src, parser.AllErrors)
if err != nil {
// err 是 *parser.ErrorList，可遍历打印每条错误的 Position
for _, e := range err.(scanner.ErrorList) {
fmt.Printf("%s: %s\n", fs.Position(e.Pos), e.Msg)
}
}
-
parser.AllErrors必须加，否则遇到第一个错误就停，漏掉后续问题 - 别用
fmt.Println(err)打印，它不会自动调用ErrorList的格式化逻辑 - 如果你在 IDE 插件或 LSP 场景下使用，
token.FileSet还要复用，否则位置映射错乱
AST 重写后为什么生成的代码格式全乱了？
Go 的 AST 节点本身不存空白符、换行、缩进信息，go/printer 默认用紧凑格式输出（比如把 if x { y() } 打印成一行）。这不是 bug，是设计使然：AST 关注结构，格式是另一层职责。
解决路径只有两个：要么用 go/format 二次处理，要么给 printer.Config 配置选项。
-
go/format.Node内部就是调go/printer+go/scanner，适合最终输出前“整形”，但多一次 parse → print 循环，性能敏感场景慎用 - 更轻量的是配置
printer.Config：设置Mode: printer.UseSpaces | printer.TabIndent和Tabwidth: 4 - 注意：AST 修改后若删了某个
ast.CommentGroup，go/printer就真不会输出注释——注释不是语法必需，它只在ast.File.Comments和节点的Doc/Comment字段里显式挂载才生效
最常被忽略的一点：AST 节点的 Pos() 和 End() 位置信息，在手动构造新节点时必须显式设置，否则 go/printer 无法对齐换行逻辑，尤其在插入语句或包裹表达式时。
