go:generate 不自动执行，需手动运行且满足三条件：在目标包目录下、注释顶格无空格、工具在PATH中；生成文件包名须匹配导入路径；多指令按源文件从上到下顺序执行。

go:generate 命令不执行？检查这三件事

go:generate 不是魔法，它只是个注释解析器，不会自动运行。你得手动敲 go generate 才会触发——这点很多人卡住半天才发现。

• 必须在目标包目录下运行 go generate，不能在项目根或子目录外乱跑
• //go:generate 注释必须顶格、无空格、冒号后紧跟空格，写成 //go:generate go run gen.go 才有效，//go:generate\tgo run... 会被忽略
• 命令里用的工具（比如 stringer、mockgen）得在 $PATH 里，否则报 exec: "stringer": executable file not found

生成代码后 import 报错：路径和包名对不上

go:generate 本身不管生成文件的包声明，全靠你写的命令决定输出内容。常见错误是生成的文件用了 package main，但你试图在 package foo 里 import 它。

• 生成命令里如果调用 go run gen.go，确保 gen.go 输出的文件开头是 package foo，不是 package main
• 用 stringer 时默认输出到当前目录，加 -output=foo_string.go 控制文件名，但包名仍由源文件决定——源 enum 类型得在 package foo 下
• 生成文件别手动生成后又 git commit 进去；建议加 //go:generate go run gen.go && go fmt gen_*.go，避免格式不一致导致 import 失败

多个 generate 指令怎么控制执行顺序？

go:generate 按源文件中注释出现的**从上到下顺序**执行，不支持依赖声明或并发控制。

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

• 想让 A 生成完再跑 B？把 //go:generate A 写在 B 上面就行
• 跨文件依赖？不行。go:generate 只处理单个 .go 文件里的指令，不能跨文件调度
• 需要条件执行？没有 if/else。可以用 shell 命令绕过，比如 //go:generate sh -c "test -f config.yaml && go run gen_config.go"

为什么 go:generate 在 CI 里总失败？

CI 环境通常没装生成工具，或者 GOPATH/GOROOT 配置和本地不一致，导致命令找不到或编译失败。

立即学习“go语言免费学习笔记（深入）”；

• 所有生成命令里用的二进制，都该用 go install 显式安装，比如 go install golang.org/x/tools/cmd/stringer@latest
• 别用相对路径写脚本，如 ./gen.sh；改用 go run ./cmd/gen 或绝对路径 $(go env GOPATH)/bin/stringer
• 生成文件最好加到 .gitignore，但要在 CI 的 go generate 后立刻 git diff --quiet 校验——防止有人漏提交生成结果却没报错

事情说清了就结束。真正麻烦的是生成逻辑嵌套、多平台输出、以及生成代码和手写代码的边界怎么划——这些没法靠一行注释解决。