go generate 是一个注释驱动的代码生成工具，需手动执行且不参与构建流程；它通过 //go:generate 指令调用外部命令，结合模板与配置生成类型专用代码，避免重复实现。
go generate 是什么，不是什么
go generate 不是构建流程的一部分，不会自动执行，也不参与依赖分析或缓存。它只是个“注释触发器”——你写一行 //go:generate xxx，然后手动运行 go generate，它就去调 xxx 命令。很多人误以为加了注释就万事大吉，结果编译时才发现生成代码根本没跑，或者跑在错误目录下。
- 必须显式执行
go generate（支持-v查看命令、-n预览不执行） - 工作目录默认是当前包路径，不是
go.mod根目录，跨包调用要小心相对路径 - 生成的文件不会被
go build自动感知，得确保它们在.go后缀且可导入范围内
生成代码前怎么避免手写模板爆炸
泛型落地前，为不同类型重复实现 Map、Set 或序列化逻辑很常见。直接复制粘贴改类型名，后期维护成本极高。这时候 go generate + 模板才是正解，而不是硬编码一堆 IntMap、StringMap 文件。
- 用
text/template写模板，把类型名、方法名作为参数传入，比 shell 替换更可控 - 模板里避免写复杂逻辑，只做字段/函数名拼接；类型检查留到生成后
go vet或 CI 里做 - 别把模板和生成脚本混在一个文件里，建议分三块：模板（
map.tmpl）、配置（types.yaml）、生成器（gen/main.go）
示例：模板中写 {{.KeyType}}Map，配置里定义 KeyType: int，生成器读取后渲染出 intMap.go。
常见报错：exec: "xxx": executable file not found in $PATH
这是 go generate 最常卡住的地方。你以为写了 //go:generate go run gen/main.go 就能跑，但实际可能因为 GOBIN 未设、模块未初始化、或 main.go 里用了 go:build 约束导致找不到可执行文件。
立即学习“go语言免费学习笔记（深入）”；
- 优先用
go run而非假设二进制已安装，尤其 CI 环境里不要依赖$GOBIN - 如果生成器本身依赖其他模块，确保它所在目录有
go.mod，且go run能解析 import - Windows 下注意路径分隔符，
go:generate注释里的反斜杠容易被当成转义，统一用正斜杠或双反斜杠 - 错误信息里的
xxx实际是你要执行的命令名，不是 Go 报错，先which xxx或where xxx确认是否存在
生成代码后为什么 test 总失败？类型擦除陷阱
泛型前靠生成模拟多态，但所有实例都是独立类型。比如你生成了 IntList 和 StringList，它们之间没有公共接口，也不能用同一个函数参数接收——除非你提前定义好 List 接口并让两者都实现它。
- 生成器输出前，务必补全
func (x *IntList) Len() int这类基础方法，否则无法对接标准库如sort.Slice - 别指望生成代码能自动满足泛型约束（比如
comparable），得人工检查字段是否可比较，必要时加//go:generate的条件判断分支 - 生成的测试文件容易漏掉
package list_test或导入路径写死，导致go test找不到被测包
最容易被忽略的是：生成器本身也要测试。写个 TestGenerateOutput，对比期望字符串和实际生成内容，否则改了模板都不知道破了哪。
