go generate是手动触发的标记驱动工具，仅执行//go:generate注释后的命令，不参与构建、不解析代码、不自动运行；注释须顶格、在包级作用域、路径相对文件所在目录，且需严格遵循格式规范。
直接用 go generate 触发、用 go/parser 解析 AST、再用 go/format.Source 输出，是目前最稳的 Go 代码生成路径。手拼字符串或模板渲染容易崩在关键字、缩进、括号配对上；AST 链路虽然写法啰嗦，但能保证生成结果 100% 可 go build。
go:generate 注释为什么总不生效
常见错误不是命令写错，而是注释格式或位置不对：
-
//go:generate必须顶格，// go:generate（前面多空格）会被完全忽略 - 不能出现在函数体、struct 定义中间——它只对所在
.go文件生效，且 parser 要求它在包级作用域（即 import 后、任何声明前） - 路径是相对于该文件所在目录的，不是执行
go generate的工作目录。比如//go:generate go run ./gen/main.go，这个./gen/是从当前文件所在目录算起 - 命令中含
|、、<code>>等 shell 特性时，go generate不解析，必须用sh -c "..."包一层
parser.ParseFile 为什么一读函数体就 panic
默认模式下 parser.ParseFile 会跳过函数体（FuncDecl.Body 为 nil），这是性能优化，不是 bug。要读完整 AST，必须显式加 flag：
- 正确写法：
parser.ParseFile(fset, filename, src, parser.ParseComments|parser.ParseFullFiles) -
ParseComments和ParseFullFiles必须同时传，单独加没用 - 如果只提取结构体字段或接口方法签名，可以不用
ParseFullFiles，解析更快、内存更少 - 漏掉
ParseFullFiles却去访问funcNode.Body.List，就会 panic: "invalid memory address"
用 ast 构造节点后为什么输出为空或报错 invalid node
AST 不是树形结构的自由组装，而是强依赖三层绑定关系：
立即学习“go语言免费学习笔记（深入）”；
-
*ast.File必须挂载有效的*token.FileSet，否则go/format.Node会 panic: "nil *token.FileSet" - 新构造的
*ast.ValueSpec必须放进*ast.GenDecl.Specs（slice），不能直接赋给*ast.GenDecl字段 - 替换节点时，必须在父节点上显式重赋值：比如改
fmt.Println为log.Println，得在*ast.ExprStmt里把ExprStmt.X指向新*ast.CallExpr，而不是只改CallExpr.Fun - 注释要用
*ast.CommentGroup类型，不是字符串；想插到函数前，得赋给*ast.FuncDecl.Doc，不是Comment
生成的代码为什么 go vet 通不过或编译失败
90% 的问题出在漏了 go/format.Source 这一步：
-
go/format.Node输出的是字节流，不是带换行缩进的可读字符串；直接fmt.Println看不到真实格式 - 必须用
format.Source(dstBytes)做最终整形，哪怕你模板里写了 4 个空格，不走这步就可能缺分号、多逗号、括号错位 - 标识符（如字段名
type、func）必须转义，否则生成type string这种非法语法；建议用ast.Print写入bytes.Buffer再转字符串 - 路径解析错位会导致
import找不到——别用filepath.Abs(".")，改用go list -m -f "{{.Dir}}"拿模块根目录
最易被忽略的点是：AST 节点之间引用必须完整，漏一层父节点赋值，整个子树就丢了；而 go/format.Source 不只是“美化”，它是语法合法性兜底的最后防线。
