必须绕开token.FileSet为空、未加parser.ParseFullFiles、ast.Inspect改节点、go/format.Node传nil *token.FileSet四大panic点；parser.ParseFile需非nil fset、非空src字节切片、含ParseComments和ParseFullFiles的mode、严格检查err，否则file为nil或.Body为nil。
直接用 go/parser + go/ast 做自动化代码处理，不是“能跑就行”，而是必须绕开几个硬性 panic 点——token.FileSet 为空、parser.ParseFile 忘加 parser.ParseFullFiles、ast.Inspect 里改节点、go/format.Node 传了 nil *token.FileSet，任一踩中都会让整个流程在 CI 上静默失败或 panic。
为什么 parser.ParseFile 一调就 panic 或返回 nil file
它不自动建 token.FileSet，也不校验源码是否 UTF-8 合法，更不会帮你跳过语法错误。漏掉任一环节，file 就是 nil，后续所有 .Pos() 返回 0，ast.Inspect 遍历直接崩溃。
-
fset必须非 nil：用token.NewFileSet()创建，别复用旧的（位置信息会错乱） -
src要是非空字节切片：比如os.ReadFile("handler.go")的返回值，不是路径字符串 -
mode至少带parser.ParseComments：否则注释全丢，FuncDecl.Doc为空 - 若需访问函数体（如提取参数名、日志埋点），必须显式加
parser.ParseFullFiles：默认模式下FuncDecl.Body是 nil - 必须检查
err != nil：BOM 头、CRLF/LF 混用、泛型语法错误都可能导致err非 nil
ast.Inspect 为什么不能改节点，而 ast.Walk 又难用
ast.Inspect 回调签名是 func(ast.Node) bool，只读遍历，返回 false 可中断，但改了节点字段也没用——AST 是只读结构，父节点引用没变，生成代码时照样丢。
- 想替换
fmt.Println为log.Println，得在父节点（如*ast.ExprStmt）里显式重赋值exprstmt.X = newCallExpr -
ast.Walk的 Visitor 不负责替换，只控制是否继续遍历；替换动作必须手动写在父节点上 - 如果父节点是
*ast.File，它的Decls是 slice，替换某个GenDecl得用切片操作重赋值，不能只改局部字段 - 漏掉某层父引用，生成的 AST 会丢失该节点，
go/format.Node输出为空或报invalid node
生成代码时 go/format.Node 总是 panic 或输出乱码
go/format.Node 不接受孤立节点，也不容忍 nil *token.FileSet，更不会自动补 import 或格式化缩进——它只做一件事：把合法 AST 格式化成标准 Go 字节流。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
-
ast.File必须挂载到有效的token.FileSet上，否则 panic：nil *token.FileSet - 生成的
ast.Expr或ast.Stmt不能孤立存在，必须挂到*ast.File.Decls或函数体Body.List中 - 输出必须用
bytes.Buffer接收，go/format.Node(&buf, fset, node)，不是fmt.Printf - import 要手动管理：
ast.File.Imports里塞*ast.ImportSpec，路径必须是&ast.BasicLit{Kind: token.STRING, Value: `"fmt"`}，且需按字母序排好，否则go fmt会重排甚至合并分组 - 生成后务必再走一次
format.Source：哪怕 AST 构建正确，少了换行或空格也可能导致go vet报错
什么时候该放弃 AST，改用正则+状态机
如果你只需要提取函数名、参数类型名、返回值类型名和注释标记（比如 // @mock: true），AST 是杀鸡用牛刀——它要加载 go.mod、解析 import、展开类型别名、推导泛型，稍有不慎就 panic 或漏掉 interface{} 这类无名类型。
- 用
bufio.Scanner逐行读，避免一次性加载大文件 - 遇到
"或`开头的行，跳过整行或进入字符串状态 - 匹配
func\s+(\w+)\s*\(([^)]*)\)\s*(\([^)]*\))，再对参数列表按逗号切分，取每个片段最后一个非空 token 作为类型名（如req *http.Request→*http.Request） - 忽略带括号的返回类型声明（如
(int, error)），统一按逗号切分后分别处理 - 速度提升 3–5 倍，且不依赖
GOROOT或模块初始化
最常被忽略的一点：所有 AST 操作都建立在「源码字符串本身是合法 Go 语法」的前提上。一旦输入含非法泛型、未闭合字符串、BOM 头或混合换行符，parser.ParseFile 就会失败——你得先做预清洗，而不是指望 AST 层兜底。
