GO语言基础教程（195）Go编译与测试工具之go generate命令：Go生成器：让代码自动编写代码的黑科技

在Go语言的世界里，有一种魔法，可以让你的代码自己生成代码，这就是//go:generate指令。

01 什么是go generate？代码生成的神奇魔法

在Go语言1.4版本中，悄悄加入了一个新的命令——go generate。这个命令看起来简单，却拥有强大的能力。

简单来说，当你运行go generate命令时，它会扫描当前包中所有的Go源文件，寻找那些特殊的注释//go:generate，然后提取并执行这些注释后面的命令。

这与go build或go run有什么不同呢？go build专注于编译代码，go run专注于编译并运行程序，而go generate则专注于在编译之前生成代码。

你可以把它看作是一个预编译步骤，专门用来自动化生成那些重复性高、容易出错的代码。

举个例子，假设你有一个枚举类型，想要为它实现String()方法，手动编写不仅繁琐，而且每次添加新的枚举值都需要更新这个方法。

使用go generate，你只需要一个简单的命令，就能自动完成这个任务，既节省时间又避免错误。

02 go generate的基本用法：让你的代码学会“自言自语”

要使用go generate，首先需要在你的Go源文件中添加特殊的注释。这些注释的格式非常严格，双斜线后面不能有空格，必须是//go:generate。

//go:generate stringer -type=Pill
type Pill int

const (
 Placebo Pill = iota
 Aspirin
 Ibuprofen
)

在这个例子中，我们告诉Go工具链：当你运行go generate时，请执行stringer -type=Pill这个命令。stringer是一个自动为整数常量生成String方法的工具，它是Go官方工具集的一部分。

那么，如何触发这个魔法呢？非常简单，只需要在终端中运行：

go generate

默认情况下，go generate只处理当前工作目录下的包，但你也可以指定其他路径。比如，go generate ./...会处理当前目录及其所有子目录下的包。

需要注意的是，所有go generate命令都会忽略vendor目录和GOROOT下的包，仅处理项目内的用户代码。

go generate命令还提供了一些有用的参数：

• -v：输出被处理的包名和源文件名
• -n：显示但不执行命令
• -x：显示并执行命令

这些参数在调试和验证go generate命令时非常有用，你可以先使用-n参