1.简介

go build 是 Go 语言工具链中的一个命令，它用于编译 Go 源代码并生成可执行文件。

2.格式

go build [-o output] [build flags] [packages]

• 可选的 -o 选项强制 build 将生成的可执行文件或对象写入指定的输出文件或目录。如果不指定，默认会生成当前目录下的可执行文件，文件名与包名相同。
• build flags: 可选的构建标志，用于指定构建的行为。
• packages: 要编译的包或目录。如果不提供，go build 将编译当前目录下的包。

3.选项

-a强制重新编译所有包，即使它们已经是最新的。这在修改了依赖项后很有用。
-buildmode <mode>用于指定构建的模式。根据所选的模式，Go 可以生成不同类型的输出，适用于不同的使用场景。比如 default 默认模式，生成一个可执行文件，shared 生成共享库，archive 生成静态库等。详见 go help buildmode。
-C <dir>运行命令之前，切换到指定目录。命令行上命名的任何文件都会在更改目录后进行解释。如果使用此标志，则必须是命令行中的第一个标志。
-o <file>指定生成的可执行文件的名称。如果不指定，默认会生成与包名相同的可执行文件。
-v显示详细的构建过程，包括每个包的编译信息。
-race启用数据竞争检测。这将使编译器添加用于检测并发数据竞争的代码。
-x显示构建过程中执行的命令，包括编译器和链接器的调用。
-tags <tag,list>指定构建时使用的构建标签，逗号分隔。标签可以控制编译的条件，例如启用或禁用某些代码块。
-gcflags '[pattern=]arg list'用于设置传递给 Go 编译器的标志，这些标志会影响编译过程中的垃圾收集器的行为。这个选项可以用于调试和优化编译过程。常用标志:-m: 提示编译器提供内存逃逸分析的信息。-m <expr>: 只显示与特定表达式相关的内存逃逸信息。-l: 禁用内联优化。-N: 禁用优化。
-ldflags <flags>设置链接器标志，用于控制链接过程。
-installsuffix <suffix>为当前构建指定一个安装后缀，这通常用于创建不同版本的二进制文件。
-trimpath移除构建路径中的文件系统路径信息，从而在构建过程中避免泄露本地路径信息。

4.示例

（1）编译当前目录的代码。

go build

（2）编译并指定输出文件名。

go build -o myprogram

（3）编译并显示详细信息。

go build -v

（4）禁止内联优化。

go build -gcflags="-l" mypackage

（5）显示构建过程中执行的命令，包括编译器和链接器的调用。

go build -x

5.小结

go build 命令提供了丰富的选项，使得编译 Go 程序更加灵活和高效。通过合理使用这些选项，可以满足不同的构建需求，如输出文件命名、启用调试、交叉编译等。

在开发过程中，灵活运用这些选项将有助于提高开发效率和代码质量。

---

参考文献

go command - cmd/go