go:generate 本身不支持 shell 重定向语法（如 <、>），但可通过 sh -c 包裹命令间接实现 stdin/stdout 重定向，从而调用管道型工具生成 Go 源码。
go:generate 本身不支持 shell 重定向语法（如 ``），但可通过 `sh -c` 包裹命令间接实现 stdin/stdout 重定向，从而调用管道型工具生成 go 源码。
go:generate 是 Go 官方提供的代码生成机制，用于在 go generate 执行时自动运行外部命令。它语义简洁、跨平台兼容性好，但原生仅支持直接命令调用，不解析 shell 特性（如管道、重定向、变量扩展等）。因此，像 //go:generate tool < input.txt > output.go 这样的写法会失败——Go 解析器会将 < 和 > 视为非法 token，而非 shell 操作符。
✅ 正确做法是借助系统 shell 解释器执行复合命令。最通用、可移植的方式是使用 sh -c：
//go:generate sh -c "tool < file.txt > file.go"
该指令中：
- sh -c 启动一个 POSIX 兼容 shell；
- 后续双引号内的字符串由 shell 解析，< 和 > 被正确识别为输入/输出重定向；
- tool 从 file.txt 读取数据，处理后将 Go 源码写入 file.go。
? 补充说明与最佳实践：
-
跨平台注意：sh -c 在 Linux/macOS 和 Windows（需启用 WSL 或安装 Git Bash 等 POSIX 环境）均有效；若需纯 Windows 原生支持，可改用 cmd /c（但需转义语法）：
//go:generate cmd /c "tool < file.txt > file.go"
不过 sh -c 更推荐，因其行为更一致且符合 Go 生态惯例。
路径与工作目录：go:generate 始终在当前 .go 文件所在目录下执行命令。确保 file.txt 和生成目标路径为相对路径（或使用 $GOFILE、$GOPACKAGE 等环境变量增强健壮性）。
-
错误处理与调试：
- 添加 -x 参数查看实际执行命令：go generate -x
- 工具应遵循 Unix 哲学：成功时返回 0，出错时输出清晰错误到 stderr 并返回非零状态码，go:generate 将自动捕获并中止构建。
-
进阶示例（带参数与模板）：
//go:generate sh -c "echo 'package main; const Version = \"$(git describe --tags)\"' > version.go"
⚠️ 重要提醒：避免在 go:generate 行中嵌入复杂逻辑或长脚本。若逻辑变重，建议将命令提取至独立 shell 脚本（如 gen.sh），再通过 //go:generate ./gen.sh 调用，提升可维护性与可测试性。
总之，sh -c 是打通 go:generate 与 shell 重定向能力的关键桥梁——它不改变 Go 工具链设计哲学，却以最小侵入方式释放了强大灵活性。
