parser.ParseFile 必须配合新创建的 *token.FileSet 使用，文件名不可为 nil（可用""），mode 决定注释和错误处理行为；AST 字段如 f.Name、f.Decls 等在边界场景下天然为 nil，需显式判空；遍历应使用 ast.Inspect 而非手动 type-switch；自定义 DSL 解析需从 lexer 和 parser 全流程重写。
parser.ParseFile 传参不对，AST 直接为 nil 或 panic
调用 parser.ParseFile 时最常见的失效原因是参数组合错误。它不接受任意字符串，必须配合 token.FileSet 使用，且文件名参数不能为 nil —— 即使你只解析内存字符串，也得传空字符串 "" 或占位符路径。
-
fset必须是新创建的、未被其他 goroutine 复用的*token.FileSet；共享会导致位置信息错乱甚至 panic - 第二个参数（文件名）传
""合法，但错误提示里会显示<standard input>；若需精准定位，建议传绝对路径（如/tmp/x.go） - 第四个参数是
mode，常见值有0（忽略注释）、parser.ParseComments（保留f.Comments）、parser.AllErrors（收集全部语法错误而非遇到第一个就停） - 如果传入非法 Go 代码（比如少个括号），
err非 nil，但f可能非 nil —— parser 会尽力恢复，此时f.Decls或f.Name仍可能为 nil，直接访问必 panic
遍历 ast.File 时字段为空导致 panic 的高频点
ast.File 看似扁平，但多个字段在边界场景下天然为 nil，不是“文档没写清楚”，而是 Go AST 设计如此：它只反映语法结构，不做语义补全。
-
f.Name：空文件、仅含注释或 package 声明缺名字（如package）时为 nil -
f.Decls：合法空文件返回空切片（[]ast.Node{}），但语法严重错误时可能为 nil；务必先判f != nil && f.Decls != nil -
f.Comments：仅当mode包含parser.ParseComments才非 nil；即使有注释，也要再判len(f.Comments) > 0才安全取f.Comments[0].List -
f.Scope永远为 nil ——go/ast不做作用域分析，那是go/types的事，别试图访问它
用 ast.Inspect 替代手写 switch，避免漏类型和崩溃
手动对 node.(type) 写一堆 case *ast.FuncDecl、case *ast.ExprStmt 很容易出问题：Go 新版本加了节点类型（比如 Go 1.18 的 ast.TypeSpec.TypeParams），你的 switch 就会跳过它们，还可能因类型断言失败 panic。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
-
ast.Inspect是官方推荐的通用遍历方式，它自动覆盖所有实现ast.Node接口的类型，无需维护 case 列表 - 回调函数签名是
func(node ast.Node) bool，返回false可跳过当前节点及其全部子树（例如跳过func TestXxx） - 注意：
Inspect不保证访问顺序，也不防止重复访问同一节点（比如ast.Ident在表达式和类型中各出现一次）；逻辑需幂等 - 它只读，改 AST 节点无效；真要重写，得用
golang.org/x/tools/go/ast/astutil或手动构造新节点
自定义 AST 转换不能靠 go/parser，得从 lexer 开始重写
如果你的目标不是分析 Go 源码，而是把 DSL 字符串（比如 "a + b * 2 > 10" 或配置规则 "when user.age > 18 then notify()"）转成自己的结构体，go/parser 完全无用 —— 它硬编码了 Go 语法规则，无法扩展 token 类型或调整优先级。
立即学习“go语言免费学习笔记（深入）”；
-
go/parser返回的是固定ast.Node实现（如*ast.BinaryExpr），字段不可增删，行为不可覆盖 - 正确路径是：定义你的 AST 结构体 → 写 lexer（用
bufio.Scanner或状态机切 token，别用strings.Split处理浮点数或负号）→ 写递归下降 parser（按运算符优先级分层 parse，如先+/-再*//） - 性能关键点：token 流应单次遍历，用索引或迭代器推进；避免在 parser 中反复调用正则或
strings.FieldsFunc - 错误定位依赖 lexer 记录每个 token 的
token.Position，否则用户看到parse error at line 1根本没法调试
真正卡住人的地方不在“怎么写 parser”，而在于默认假设 AST 是可写的、可扩展的、字段全非 nil 的。实际上，go/ast 是只读快照，go/parser 是 Go 专用解析器，两者都不服务自定义语法。需要转换 DSL，就得亲手接管 lexer 和 parser 全流程。
