安全调用 ast.ParseFile 需创建非 nil token.FileSet、传入非空字节源码、启用 parser.ParseComments 模式，并严格检查 err；ast.Inspect 是唯一覆盖全节点类型的遍历方式；类型信息需借助 go/packages 加载并解析，struct tag 需清洗后交 reflect.StructTag 处理。
不能直接用字符串匹配做 Go 源码静态分析 —— AST 是唯一可靠起点，但必须绕过 parser.ParseFile 的常见 panic 陷阱。
怎么安全调用 ast.ParseFile 解析字符串源码
传字符串进 ast.ParseFile 不是把代码丢进去就完事。它不自动校验 UTF-8、不跳过语法错误、也不帮你建 token.FileSet。漏掉任一环节，file 就是 nil，后续所有 .Pos() 返回 0，ast.Inspect 遍历直接 panic。
-
fset必须非 nil：用token.NewFileSet()创建，别传nil或复用旧的（位置信息会错乱） -
src参数要非空：比如os.ReadFile("main.go")的返回值，不是文件路径字符串 -
mode至少带parser.ParseComments：否则注释节点全丢，FuncDecl.Doc为空 - 必须检查
err != nil：语法错误、BOM 头、换行符混用（CRLF/LF）都可能导致err非 nil，file为 nil
正确示例：
fset := token.NewFileSet()
src, _ := os.ReadFile("handler.go")
file, err := parser.ParseFile(fset, "", src, parser.ParseComments)
if err != nil {
log.Fatal(err) // 别忽略！
}
// 此时 file 才可安全使用
为什么 ast.Inspect 是遍历首选，而不是手写递归
手写递归遍历 *ast.File.Decls 看似简单，但实际会漏掉大量节点：比如 func() {} 这类 *ast.FuncLit 不在 Decls 里；switch 分支里的 fallthrough 在 *ast.CaseClause.Body 中，不在顶层语句列表；type T struct{ f int } 的字段定义藏在 *ast.StructType.Fields，不经过 GenDecl 就根本碰不到。
立即学习“go语言免费学习笔记（深入）”；
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
-
ast.Inspect自动覆盖全部节点类型，包括*ast.FuncLit、*ast.CompositeLit、*ast.TypeSpec等冷门但高频结构 - 回调函数签名是
func(ast.Node) bool，返回false可立即中断（如只找第一个main函数） - 它跳过所有
nil字段，避免手写时因f.Type.Params == nil而 panic - 别在回调里修改节点：AST 是只读结构，改了也没用，还可能干扰后续遍历逻辑
如何从 *ast.Ident 拿到真实类型（不是字符串名）
go/ast 本身不提供类型信息 —— 它只管“长什么样”，不管“是什么类型”。比如 textToContain := bytes.NewBuffer(nil)，*ast.Ident 节点里只有名字 textToContain 和声明位置，没有 *bytes.Buffer 这个类型。
- 必须引入
golang.org/x/tools/go/packages加载包并执行类型检查 - 配置
packages.NeedTypes | packages.NeedTypesInfo，否则types.Info为空 - 通过
types.Info.Types[ident].Type获取类型对象，再用types.TypeString转成可读字符串 - 注意：单文件解析容易失败，推荐加载整个模块（
packages.Load(cfg, "./...")），否则导入路径解析不全
关键链路：ast.Ident → types.Info.Types[ident].Type → types.TypeString(t)
提取 struct tag 时，reflect.StructTag 怎么和 AST 配合用
ast.Field.Tag 是 *ast.BasicLit，值类似 "`json:\"name\" db:\"user_name\"`"。它只是原始字符串，没法直接判断 json tag 是否合法或是否重复。
- 先用
strings.Trim(field.Tag.Value, "`\"'")清洗引号 - 再传给
reflect.StructTag(tagStr)—— 这是反射包里少数纯字符串处理、不依赖运行时值的工具 - 用
.Get("json")提取字段，若返回空字符串，说明 tag 格式非法（比如漏了:或引号不配对） - 别直接对
ast.Expr调reflect.TypeOf：它不是运行时值，会 panic
常见坑：字段没写 tag（field.Tag == nil）、tag 值含非法字符（如逗号未转义）、或用了单引号但 reflect.StructTag 只认双引号包裹的值。
真正难的不是写遍历逻辑，而是处理那些“看起来有、其实为 nil”的字段：比如 FuncDecl.Type.Params 是 nil 而不是空切片，Field.Names 是空 slice 而不是 nil，Ident.Obj 在未声明变量时为 nil。这些边界条件不提前 guard，静态分析工具上线第一天就会在用户代码上 panic。
