安全调用parser.ParseFile需四步：fset必须用token.NewFileSet()创建且不复用；磁盘解析时src设nil、传真实路径；内存解析时src传非空[]byte、文件名不可为空字符串；mode至少含parser.ParseComments；必须检查err!=nil再访问file。
直接调用 parser.ParseFile 解析源码是可行的，但不安全 —— 90% 的 panic 和 nil 返回都源于参数错配或忽略错误检查。
怎么安全调用 parser.ParseFile 解析磁盘文件
它不会自动读取文件内容，必须显式传入路径且让 src 参数为 nil；否则解析器会跳过磁盘读取逻辑，返回空 *ast.File。
-
fset必须非nil：用token.NewFileSet()创建，复用旧FileSet会导致所有.Pos()偏移错乱 - 第二个参数是文件路径字符串（如
"main.go"），会被用于错误提示，不校验是否存在 - 第四个参数
mode至少带parser.ParseComments，否则FuncDecl.Doc、TypeSpec.Doc全为空 - 必须检查
err != nil：BOM 头、CRLF/LF 混用、语法错误都会让file为nil，后续任何.Pos()或遍历都 panic
怎么安全解析字符串源码（比如从内存加载）
不能把源码字符串当路径传，也不能漏掉 FileSet 和 mode。常见错误是传了 "" 当文件名 + 字符串源码，却没设 parser.ParseComments，结果注释全丢。
-
src参数必须是非空字节切片（如[]byte("package main; func f() {}")），不是string类型 - 第二个参数只是占位名（如
"dummy.go"），不参与读取，但不能为空字符串（会 panic） -
mode至少含parser.ParseComments；若源码不完整（缺 import 等），可加parser.SkipObjectResolution避免类型解析失败 - UTF-8 校验由调用方负责：
utf8.Valid(src)最好前置检查，否则解析可能静默失败
为什么必须用 ast.Inspect 而不是手写递归遍历
手写递归只扫 file.Decls，会漏掉函数字面量、结构体字段、switch 分支里的语句、匿名参数等高频节点 —— 因为 AST 结构和语法定义严格对应，不是“看着像声明就是声明”。
立即学习“go语言免费学习笔记（深入）”；
-
ast.Inspect自动覆盖全部节点类型：*ast.FuncLit、*ast.CompositeLit、*ast.TypeSpec全部命中 - 回调函数签名是
func(ast.Node) bool，返回false可立即中断（如只找第一个main函数） - 它跳过所有
nil字段，避免手写时因f.Type.Params == nil导致 panic - 别在回调里修改节点字段（如
node.(*ast.BasicLit).Value = "new"）：AST 节点不可变，改了也不生效
替换字符串常量时为什么不能直接改 Value 字段
ast.BasicLit 是只读结构体，且 go/format 输出时完全不看 Value 字段值 —— 它只根据节点类型、位置和子节点生成代码。改了 Value，输出还是原样。
- 正确做法是：定位到该
ast.BasicLit后，构造新节点&ast.BasicLit{Kind: token.STRING, Value: strconv.Quote(newStr)} - 再替换其父节点中的对应引用：可能是
ast.ExprStmt.X、ast.AssignStmt.Rhs、ast.ReturnStmt.Results等，需动态判断 - 替换后必须用
go/format.Node或go/printer.Fprint输出，且所有节点的Pos/End必须有效，否则 panic - 原始格式（双引号 or 反引号）由
strconv.Quote自动决定，别手拼引号或转义
最易被忽略的是：所有节点位置信息（Pos）依赖 token.FileSet，一旦复用或传 nil，go/format 就无法对齐换行和缩进，输出代码会严重错乱。
