go/ast.ParseFile易panic或返回nil，根本原因是路径、源码或模式参数不匹配；需区分磁盘读取（src设为nil）与字符串解析（src非nil），并正确传入token.FileSet和parser.Mode。
go/ast.ParseFile 为什么总 panic 或返回 nil
根本原因通常是文件路径、源码内容或模式参数没对上。go/ast.ParseFile 不会自动读取磁盘文件内容，除非你传的是真实路径且 src 参数为 nil；如果传了字符串源码，就必须把 src 设为非 nil，否则解析器会忽略它。
- 常见错误现象：
panic: interface conversion: ast.Node is nil, not *ast.File，基本等于你传了空字符串、非法 UTF-8 或语法错误的源码，又没检查err - 正确用法分两种场景：
– 从磁盘读：调用go/ast.ParseFile(fset, "main.go", nil, 0)，其中fset是token.NewFileSet()
– 从字符串读：go/ast.ParseFile(fset, "dummy.go", "package main; func f() {}", parser.ParseComments)，注意第二个参数只是占位名，不校验路径 - 别漏掉
parser.Mode参数：想提取注释必须加parser.ParseComments；想跳过类型检查（比如源码不完整），加parser.SkipObjectResolution
遍历 AST 时为什么找不到函数体或参数名
go/ast 的结构是严格按 Go 语法定义的，不是“看着像什么就是什么”。比如函数声明是 *ast.FuncDecl，但它的 Func 字段只是关键字 token，函数体在 Decl.Body，参数列表在 Decl.Type.Params.List —— 这些字段名和实际语义不直观，容易看错。
- 典型误操作：对
*ast.FuncDecl直接访问.Name得到的是标识符节点，要取名字得用.Name.Name；访问.Type前必须先确认它非 nil（接口方法或内嵌字段可能没有） - 参数名藏在
*ast.Field的Names字段里，它是个[]*ast.Ident：匿名参数（如func(int)）的Names是空切片，不能直接取[0] - 遍历时推荐用
ast.Inspect而非手写递归：它自动处理所有节点类型分支，避免漏掉*ast.GenDecl（变量/常量声明）、*ast.TypeSpec（类型定义）等冷门节点
go/ast 无法解析带 go:generate 或 //go:xxx 注释的代码
go/ast 解析器本身不识别任何编译指示注释（directive comments），它们会被当作普通 *ast.CommentGroup 存在，不会触发特殊行为。但问题在于：如果你依赖这些注释做代码生成逻辑，仅靠 AST 遍历是不够的 —— 它们不在 AST 结构里，只在 CommentMap 中以原始文本形式存在。
- 关键点：要用
ast.NewCommentMap(fset, file, file.Comments)构建映射，再手动扫描每个*ast.CommentGroup的List，逐行匹配//go:generate这类前缀 - 注意兼容性：
go:generate必须独占一行、顶格写，且后面不能有空格以外的空白符；而//go:noinline等编译指令虽格式类似，但属于 gc 编译器私有逻辑，go/ast根本不关心 - 性能影响很小：注释扫描是 O(n) 字符串匹配，比整个 AST 遍历便宜得多，但别在每次节点访问时重复构建
CommentMap
解析失败后怎么快速定位语法错误位置
go/ast.ParseFile 返回的 err 是 scanner.ErrorList 类型，它本身不带行号信息，必须结合 *token.FileSet 才能定位。很多人直接打印 err.Error()，看到的只是 “syntax error: unexpected x”，完全不知道在哪一行。
立即学习“go语言免费学习笔记（深入）”；
- 正确做法：用
fset.Position(err.Pos())获取token.Position，它有Filename、Line、Column字段；如果err是*scanner.Error，可直接调用其Pos() - 容易踩的坑：
token.FileSet必须在所有解析前创建，并透传给每一个ParseFile调用；复用同一个fset是安全的，但绝不能在不同解析间重置或新建 - 调试技巧：把出错源码按
Line截取上下 2 行打印出来，比看整段更高效；注意 Go 解析器报错位置通常是错误**之后**的第一个合法 token，比如func f() int { return }报错在}行，实际缺的是return后面的表达式
AST 解析真正难的不是调 API，而是理解 Go 语法树的“反直觉”结构：函数参数不在 FuncDecl.Params 而在 Type.Params，字段标签在 StructType.Fields.List[i].Tag 而不在 Ident 上，甚至空接口 interface{} 对应的是 *ast.InterfaceType 且 Methods 字段为 nil 而不是空切片 —— 这些细节不查源码或 fmt.Printf("%#v", node) 几乎没法猜对。
