Golang语法树ast结构详解-Golang-PHP中文网

调用 parser.parsefile 前必须检查四件事：fset 非 nil、文件名合理、mode 不为 0（如需注释加 parsecomments）、src 非 nil 且匹配读取方式；否则易 panic 或返回 nil。

golang语法树ast结构详解

直接 parser.ParseFile 返回 nil 或 panic，几乎全是调用前上下文没配齐。不是代码写错，而是环境缺失：

fset 必须非 nil：用 token.NewFileSet() 创建，漏了会导致所有 node.Pos() 返回 0，后续定位失效
第二个参数（文件名）可传空字符串 ""，但若用于磁盘读取，建议传绝对路径；若用于字符串解析，它只是占位符，不校验是否存在
第四个参数 mode 不能为 0：想拿注释就得加 parser.ParseComments；想容忍语法错误继续解析，加 parser.AllErrors
src 参数决定读取方式：传 nil 表示从文件路径读；传字符串（如 os.ReadFile 结果）则必须非 nil，否则解析器直接忽略

典型 panic 场景：panic: interface conversion: ast.Node is nil, not *ast.File，基本等于你传了空字符串、非法 UTF-8 或没检查 err != nil 就直接访问 f。

函数声明节点看着简单，但字段命名严重偏离直觉，手误就 panic：

Golang Samber Hot

在 Golang 中使用 samber/hot 进行内存缓存，支持 LRU、LFU、TinyLFU、W‑TinyLFU、S3FIFO、ARC、TwoQueue、SIEVE、FIFO 等淘汰算法，提供 TTL、缓存加载器及分片功能。

下载

函数名在 f.Name.Name，不是 f.Name——后者是 *ast.Ident 节点，直接取会 panic
参数列表藏在 f.Type.Params，但它可能为 nil（比如 func hello() {}），必须先判空再访问 .List
每个参数是 *ast.Field，名字在 field.Names（[]*ast.Ident），匿名参数（如 func(int)）该切片为空，取 [0] 必 panic
f.Doc 是函数上方的注释，但 f.Comments 是整个文件的注释列表，且仅当 mode 含 parser.ParseComments 才非 nil

手动写 switch node.(type) 容易漏掉新版本新增的节点类型（比如 Go 1.18 加的 ast.TypeSpec 中的 TypeParams），而 ast.Inspect 是官方推荐的通用遍历方式，它自动覆盖所有实现 ast.Node 的类型：

ast.Inspect 的回调函数接收 ast.Node 指针，返回 bool 控制是否继续深入子树；返回 false 可跳过整棵子树（比如跳过 test 文件里的 func TestXxx）
注意：Inspect 不保证顺序，也不保证同一节点只访问一次（如 ast.Ident 在表达式和类型中反复出现），逻辑要幂等
若需精确控制顺序或收集上下文（如当前函数名），应改用 ast.Walk 实现自定义 visitor，或用 go/types 配合 ast.Node 做语义补全

ast.File 看似简单，但几个关键字段在未显式设置或解析失败时为 nil，直接解引用必 panic：

f.Name：包名标识符，语法正确时总有值；但如果文件只有注释或空行，f.Name 可能为 nil
f.Decls：声明列表，空文件或仅含 import 语句时长度可为 0，但不会为 nil；不过若解析中途崩溃，也可能为 nil，务必先 if f != nil && f.Decls != nil
f.Scope：语义作用域，永远为 nil——go/ast 不做语义分析，作用域由 go/types 构建，别试图访问它
f.Comments：仅当 mode 含 parser.ParseComments 才非 nil；即使有注释，f.Comments 也是 []*ast.CommentGroup，每个 CommentGroup 的 List 字段才存具体注释文本