直接用 ast.ParseFile 会漏掉未格式化 Go 文件，因其默认要求语法合法，遇词法错误（如缺失括号、Shell 注释）即返回 nil；需启用 parser.AllErrors | parser.ParseComments 模式并传入 src 字节切片，配合自定义 errHandler 才能构建可用 AST。
为什么直接用 ast.ParseFile 会漏掉未格式化的 Go 文件
Go 的 ast.ParseFile 默认要求源码语法合法且无严重词法错误，比如缺失括号、错位的 import 或混入 Shell 注释（#）时，会直接返回 nil 和错误，根本进不了遍历逻辑。实际扫描存量代码或 CI 中的临时生成文件时，这类“不干净但可读”的文件很常见。
解决办法是启用宽松解析模式：parser.ParseFile 的 mode 参数传入 parser.AllErrors | parser.ParseComments，并配合自定义 errHandler 收集错误而非中断——这样 AST 树仍能构建出大部分结构，后续扫描逻辑可继续运行。
- 必须显式传
src字节切片（而非文件路径），否则无法跳过文件系统读取失败的干扰 - 若目标文件含 Go 1.21+ 的泛型类型别名（
type T = int），需确保go/parser版本与 target Go 版本一致，否则Ident节点可能被误判为普通标识符 - 注释节点（
*ast.CommentGroup）默认不挂载到 AST 子节点上，需手动调用ast.NewCommentMap关联到对应节点
如何定位并提取所有未加 //nolint 的 log.Printf 调用
这不是简单匹配函数名，因为 log.Printf 可能来自重命名导入（l "log"）、嵌套调用（wrap(log.Printf)）或方法链（logger.With().Printf）。可靠方式是遍历 *ast.CallExpr，再向上还原调用者表达式树。
关键判断逻辑：检查 CallExpr.Fun 是否为 *ast.SelectorExpr，且其 X 是 log 包的导入名（需提前记录 importSpec 映射），Sel.Name 为 "Printf"；同时跳过被 //nolint 行注释覆盖的节点位置。
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 用
ast.Inspect比递归遍历更安全——它自动处理嵌套节点和空指针 - 获取行号必须用
fset.Position(expr.Pos()).Line，不能依赖expr.Pos()原始值（那是 token 位置，非行号） - 若项目使用
zap或zerolog，它们的Sugar().Infof等等也需要在同一流程里扩展匹配，避免漏报
修改 AST 后如何安全写回原文件而不破坏格式
直接用 format.Node 输出会导致缩进重排、删除空行、合并多行注释——这对团队协作是灾难。真正安全的写回方式是：只替换目标节点对应源码区间，其余内容原样保留。
核心技巧是用 fset 获取每个节点的 Pos() 和 End()，算出字节偏移范围，再用 bytes.ReplaceAll 替换对应子串。前提是原始文件必须以 []byte 加载，且所有操作基于同一份 fset 实例。
- 不要用
gofmt或goimports自动重写整个文件——它们会改变开发者意图的格式 - 若需插入新代码（如补
//nolint），插入位置应选在语句起始行末尾（即;前或换行前），避免切到字符串字面量或注释中间 - 写回前务必校验目标文件的 MD5 是否未被其他进程修改，否则可能覆盖他人提交
ast.Inspect 遇到 nil 子节点时为什么会 panic
ast.Inspect 本身不会 panic，但它的回调函数里若对字段做盲目解引用（如 n.(*ast.CallExpr).Fun 而不先断言类型），就会触发 panic。更隐蔽的是：某些节点（如 *ast.IfStmt）的 Init、Else 字段天然允许为 nil，而文档没明确列出哪些字段可空。
正确做法是统一用类型断言 + ok 判断，或改用 ast.Walk 配合自定义 Visitor 结构体，在 Visit 方法中按需处理 nil。
- 永远不要在
Inspect回调里修改当前遍历的节点字段——这会破坏遍历器内部栈状态 - 如果需要收集多个节点再批量处理，把它们存进 slice，等
Inspect返回后再操作 - 调试时打印节点类型用
fmt.Sprintf("%T", n)，比reflect.TypeOf(n)更快且不含包路径干扰
nil 字段——这些地方一松，扫描结果就不可信。 
