因为Go的AST是只读快照，修改节点字段不影响源码；真正编辑代码需解析→修改AST→用go/format生成新源码，推荐用astutil.Apply安全替换并保留位置信息。
为什么直接修改 ast.Node 通常没用
因为 Go 的 AST 是只读快照——你改了 ast.File 或某个 ast.Expr 字段，底层源码字符串根本不会变。真正要“编辑代码”，本质是：解析 → 修改 AST → 生成新源码。很多人卡在第一步就以为 AST 改了文件就改了，结果 go fmt 一跑，改的全丢。
关键点在于：AST 修改必须配合 golang.org/x/tools/go/ast/astutil 或手动重写节点，再用 go/format 输出。否则只是内存里的幻觉。
用 astutil.Apply 安全替换函数调用
比如要把所有 log.Print(x) 替成 fmt.Println(x)。不能硬写 node.Fun = &ast.SelectorExpr{...}，容易破坏位置信息或子树结构。
-
astutil.Apply提供pre和post钩子，pre返回astutil.VisitNode控制是否进入子树，post返回替换后的新节点 - 匹配时用
ast.IsFuncCall(node, "log.Print")这类辅助判断（需自己写，标准库不提供） - 构造新调用必须用
ast.CallExpr+&ast.SelectorExpr{X: &ast.Ident{Name: "fmt"}, Sel: &ast.Ident{Name: "Println"}}，别漏Pos()继承
示例片段：
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
astutil.Apply(fset, file, nil, func(cursor *astutil.Cursor) bool {
call, ok := cursor.Node().(*ast.CallExpr)
if !ok || !isLogPrint(call) {
return true
}
// 构造 fmt.Println(...)，复用 call.Args
newCall := &ast.CallExpr{
Fun: &ast.SelectorExpr{
X: &ast.Ident{Name: "fmt"},
Sel: &ast.Ident{Name: "Println"},
},
Args: call.Args,
Lparen: call.Lparen,
Rparen: call.Rparen,
}
cursor.Replace(newCall)
return false
})
go/format.Node 输出时的编码与换行陷阱
直接 format.Node(w, fset, node) 很方便，但默认用空格缩进、Unix 换行（\n），如果原文件是 Windows（\r\n）或用了 tab，格式会“看起来被改了”——其实只是换行/缩进不一致，git diff 一大片。
- 输出前先读原文件内容，用
strings.Count(src, "\r\n")判断换行风格，再用bytes.ReplaceAll统一 - 缩进控制靠
printer.Config{Tabwidth: 4, Mode: printer.UseSpaces}，Mode设为printer.SourcePos可保留原始位置信息（对后续工具链重要） - 别用
fmt.Sprintf("%v", node)，它不带位置、无格式、不可逆
修改 import 后为什么 go build 报错找不到包
AST 层面删掉 "log" import 并不等于移除依赖——如果代码里还有未被 AST 编辑覆盖的 log.Printf 调用，构建仍失败；更常见的是：你改了 import 别名（如 log "github.com/sirupsen/logrus"），但没同步更新所有 log. 前缀的调用。
- 修改 import 必须联动扫描全部
ast.SelectorExpr，检查X是否为对应ast.Ident - 用
astutil.ImportGroup辅助定位 import 块，避免手撕ast.GenDecl中的Specs - 加个验证步骤：遍历所有
ast.CallExpr，确认Fun是*ast.SelectorExpr且Sel.Name存在，再查X的Ident.Name是否在当前 import 列表中
真正难的不是改 AST，而是让修改后的 AST 语义等价、可构建、不引入新错误——尤其当代码有嵌套宏、生成代码或 go:generate 注释时，AST 编辑很容易漏掉边界情况。
