Go 的 ast 包仅用于解析而非手写，ast.File 是根节点但字段多可空，须判空访问；FuncDecl.Params/Results 为 nil 非空切片；ast.Inspect 比类型断言更安全；token.FileSet 是位置信息唯一来源且非线程安全。
Go 的 ast 包不是用来“拼装”或“手写”的，它的结构完全由 go/parser 从合法 Go 源码中解析生成；理解它，关键在于知道哪些字段一定存在、哪些可能为 nil、以及节点之间如何嵌套关联。
ast.File 是 AST 的根节点，但它的字段大多可为空
ast.File 看似是顶层容器，但直接访问其子字段极易 panic。常见误用包括：f.Name.Name、f.Decls[0].(*ast.FuncDecl).Name.Name 等未判空就解引用。
-
f.Name是*ast.Ident，语法正确时通常非 nil，但空文件或仅含注释时可能为nil -
f.Decls类型是[]ast.Decl，长度可为 0（比如只有package main），但不会为nil；不过若解析失败中途退出，也可能为nil，务必先检查f != nil && f.Decls != nil -
f.Comments仅当 parser mode 含parser.ParseComments时才非nil；即使非 nil，也要注意CommentGroup.List才存实际文本 -
f.Scope永远为nil——go/ast不做语义分析，作用域属于go/types范畴
FuncDecl.Type.Params 和 Results 字段常为 nil，不是空切片
函数声明节点 *ast.FuncDecl 的签名信息藏在 Type 字段里，而 Type.Params 和 Type.Results 都是 *ast.FieldList 类型。它们在无参/无返回值函数中是 nil，不是 &ast.FieldList{List: []*ast.Field{}}。
- 错误写法：
for _, f := range funcDecl.Type.Params.List—— 若Params为nil，直接 panic - 正确写法：先判空，再取
List，例如if funcDecl.Type.Params != nil { for _, field := range funcDecl.Type.Params.List { ... } } -
func init()也会被识别为*ast.FuncDecl，但funcDecl.Name.Name == "init"，没有用户定义的标识符语义
所有 AST 节点都实现 ast.Node，但类型断言必须谨慎
ast.Node 只定义了 Pos() 和 End() 两个方法，不提供任何业务逻辑。遍历时靠类型断言识别具体节点，但 Go 版本升级会新增节点类型（如 Go 1.18 的 ast.TypeSpec.TypeParams），手写 switch node.(type) 容易漏掉。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 优先用
ast.Inspect，它自动覆盖所有ast.Node实现类型，无需手动枚举 - 回调中做类型判断用
if f, ok := node.(*ast.FuncDecl); ok { ... }，别用==比较指针 -
ast.Inspect不保证遍历顺序，也不提供上下文（如当前是否在某个函数体内），需要自己维护栈或状态变量 - 所有节点都是只读副本，修改字段无效；真要改代码，得用
golang.org/x/tools/go/ast/astutil或重建节点
token.FileSet 不只是“记录位置”，而是整个 AST 的坐标系基础
token.FileSet 是 AST 中所有 Pos()/End() 的唯一来源，它不是可选配件，而是强制依赖。忽略它的生命周期或复用方式，会导致位置信息错乱、甚至 panic。
- 必须在调用
parser.ParseFile前创建，且不能跨 goroutine 复用（FileSet非线程安全） - 第二个参数（文件名）传空字符串
""合法，但错误信息里路径会显示为<standard input></standard>；分析真实文件建议传绝对路径 -
fset.Position(pos)是调试和定位的关键，比如打印某函数起始行号：fset.Position(funcDecl.Pos()).Line - 不要试图把不同
ParseFile调用产生的节点混入同一fset—— 位置可能冲突或失效
最常被忽略的是：AST 节点之间没有隐式父子引用，ast.Inspect 的遍历路径也不等于源码书写顺序；如果你依赖“上一个节点是 import，下一个就是 func”，就得自己建上下文，不能靠节点相邻关系。
