直接删 fmt.Println 不够用，因人工清理易漏删误删、环境差异难统一、正则匹配不精准；应基于 go/ast 语法树识别调试语句，按原位置字符串替换剔除，嵌入 go build 流程确保生效。
为什么直接删 fmt.Println 不够用
微服务上线前手动清理 fmt.Println、log.Printf 或条件性调试块（比如 if debugMode { ... }），容易漏删、误删，还可能把本该保留的诊断日志一起干掉。更麻烦的是，不同环境（dev/staging/prod）对“调试代码”的定义不一致——有些要留，有些必须删。靠人工 grep + sed 处理，既不可靠又难复现。
用 go/ast 扫描并标记调试语句
Go 标准库的 go/ast 能安全解析源码为语法树，比正则匹配更精准。关键不是“删”，而是先识别出典型调试模式：
-
fmt.Println、fmt.Printf、fmt.Print调用（注意：排除fmt.Errorf等非调试用途） - 显式调用
log.Print*且参数不含变量插值（如log.Print("debug: start")是可疑的，log.Printf("id=%d", id)可能是正式日志） - 包裹在
if debug == true { ... }或if os.Getenv("DEBUG") != "" { ... }中的语句块
示例片段中，不要硬编码判断 "DEBUG" 字符串，而应递归遍历 ast.IfStmt 的 Cond，检查是否为环境变量读取或常量真值表达式。
AST 修改后需保持格式与行号不变
直接修改 ast.Node 并用 go/format 输出，会重排缩进、合并空行，导致 Git diff 巨大、git blame 失效、甚至影响 go tool trace 的行号映射。正确做法是：
立即学习“go语言免费学习笔记（深入）”；
- 用
go/token.FileSet定位每个待删节点的原始位置 - 不调用
ast.NewFile重建文件，而是基于原文件内容做字符串切片替换（例如：用fileset.PositionFor(node.Pos(), false).Offset获取起始偏移，再计算结束偏移） - 保留注释和空白行——跳过
ast.CommentGroup节点，不碰其 surrounding whitespace
否则，一个 // TODO: remove this debug 注释被连带删掉，就失去上下文线索了。
调试代码剔除必须与构建流程绑定
不能只在本地跑一遍脚本就完事。必须嵌入 go build 流程，否则 CI 构建产物仍含调试代码。推荐两种方式：
- 写成
go:generate指令，在go generate阶段预处理源码（注意：需配合//go:build !debugtag 控制是否启用） - 作为
go build -toolexec的 wrapper 工具，在编译前自动扫描并改写临时目录下的 .go 文件
别用 Makefile 或 shell 脚本单独执行 AST 清理——它无法感知 go build -ldflags="-s -w" 这类构建参数，也难以与 vendor 或 go.work 多模块协同。真正生效的时机，只能是编译器看到源码之前。
最易忽略的点：AST 分析必须覆盖所有 .go 文件，包括 internal/ 和 cmd/ 下的入口文件；而 go list -f '{{.GoFiles}}' 返回的路径是相对的，token.FileSet 初始化时若没传绝对路径，会导致位置计算错乱。
