Question

在源码文件中添加 shell 命令注释。由开发人员执行，常用于自动代码生成。

• 手工执行 go generate 。（其他命令不会执行）
• 必须放在 .go 源文件中。

• 以 //go:generate 开头。（不能有前置空格，双斜线后不能有空格）
• 单个文件允许有多条 //go:generate 命令。
• 支持操作系统和编译器环境变量展开。

• 单个文件内按出现顺序执行。
• 单个包内按文件名顺序执行。
• 单个包内执行出错，终止该包内后续命令。

• 命令行指定多个源码文件，视作单个包。
• 命令行指定多个包，按参数顺序执行。

//go:generate uname
//go:generate echo $HOME, $GOOS, $GOFILE

package main

$ go generate

环境变量：

• $GOARCH : 架构。
• $GOOS : 平台。
• $GOFILE : 文件名。
• $GOLINE : 行号。
• $GOPACKAGE : 包名。

命令行参数：

• -v : 显示处理的包及文件名。

• -x : 显示准备执行的命令。
• -n : 仅显示命令，不执行。
• -run <regex> : 匹配要执行的命令。（匹配 go:generate 命令，而非文件名）
• -skip <regex> : 跳过匹配的命令。

定义命令别名（-command alias），以便重复使用。仅当前文件有效。

//go:generate -command LS ls -l
//go:generate LS /var
//go:generate LS /usr