go build命令的说明

1. 获取go build说明,重定向输出到文件

go help build >> go-build-intro.txt

2. 解读go build

2.1 usage(用法)

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

build命令会编译由import path命名的包,连同它们的依赖项,但它不会安装结果,就是会编译成可执行文件。而,具体要编译成那种架构或者那种OS上的可执行文件则由​​[build flags]​​​进行定义。such as:​​GOOS=linux GOARCH=amd64​

如果构建的参数是来自单个目录的 .go 的文件列表,build 命令执行时,将它们视为指定单个包的源文件列表。(就是把他们作为一个package,所以这些.go文件的package名字一定要一致,不然会报错)


注意:​​_test.go​​结尾的go源码文件会在编译的时候被忽略,所以测试性的代码的文件名可以这么结尾,从而避免编译检查!


2.2 build说明

编译单个package main时,build 将生成的可执行文件写入以第一个源文件命名的输出文件('go build ed.go rx.go' 写入 'ed' 或 'ed.exe')或源代码目录( 'go build unix/sam' 写入 'sam' 或 'sam.exe')。编写 Windows 可执行文件时会添加“.exe”后缀,linux下没有后缀,这是二进制可执行文件。

这里注意一种build的写法,同一个package下,.go文件存在方法调用,这个时候​​go build​​​的写法要么直接​​go build .​​​,要么​​go build A.go B.go ...​​,只写入口 的go文件是会报undefined错。

当编译多个包或单个非主包时, build 编译包但丢弃生成的对象,仅用作检查包是否可以构建。

2.3 build flags说明

​-i​​​ 标志安装作为目标依赖项的包。不推荐使用​​-i​​​ 标志。 编译的包会自动缓存。不过IDE goland默认好像是有这个的,所以建议手动删除​​-i​​。

​build flags​​​包括​​build​​​构建、​​clean​​​清理、​​get​​​获取、​​install​​​安装、​​list​​​列出、​​run​​​运行、和​​test​​测试命令。

flag

describe

-a

强制重建已经是最新的包

-n

打印命令但不运行它们

-p n

可以并行运行的程序数量,例如构建命令或测试二进制文件。

默认值是可用的 CPU 数量。使用-p来指定一个数字。

-race

启用“数据争用”检测(与多线程编程有关)

Supported only on linux/amd64, freebsd/amd64, darwin/amd64,

windows/amd64, linux/ppc64le and linux/arm64 (only for 48-bit VMA)

-msan

启用与内存清理器的互操作。

Supported only on linux/amd64, linux/arm64 and

only with Clang/LLVM as the host C compiler.

On linux/arm64, pie build mode will be used.

-v

在编译时打印包的名称

-work

打印临时工作目录的名称,退出时不会删除它

-x

打印命令

-asmflags '[pattern=]arg list'

传递每个 go tool asm 调用的参数。

-buildmode mode

build mode to use. See 'go help buildmode' for more.

​-buildmode=archive​

​-buildmode=c-archive​

​-buildmode=c-shared​

​-buildmode=efault​

​-buildmode=shared​

​-buildmode=exe​

​-buildmode=pie​

​-buildmode=plugin​

-compiler name

要使用的编译器的名称,如 runtime.Compiler(gccgo 或 gc)

-gccgofags '[pattern=]arg list'

传递每个 gccgo 编译器/链接器调用的参数。

-gcflags '[pattern=]arg list'

传递每个 go 工具, 编译调用的参数。

-installsuffix suffix

在包安装目录的名称中使用的后缀,以便将输出与默认构建分开。

If using the -race flag, the install suffix is automatically set to race or, if set explicitly,

has _race appended to it. Likewise for the -msan flag.

Using a -buildmode option that requires non-default compile flags has a similar effect.

-ldflags '[pattern=]arg list'

传递每个 go 工具,链接调用的参数

-linkshared

将链接到先前使用 -buildmode=shared 创建的共享库的构建代码。

-mod mode

module download mode to use: readonly, vendor, or mod.

-modcacherw

将新创建的目录保留在模块缓存中读写,而不是将它们设为只读。

-modfile file

-overlay file

-pkgdir dir

-tags tag,list

-trimpath

-toolexec 'cmd args'

See also: go install, go get, go clean.