Golang build命令解析

本文转载自：

https://www.cnblogs.com/liuzhongchao/p/9365758.html

作者：奔梦

go build
,是我们非常常用的命令，它可以启动编译，把我们的包和相关的依赖编译成一个可执行的文件。

usage: go build [-o output] [-i] [build flags] [packages]

go build [-o 输出名] [-i] [编译标记] [包名]

如果参数为***.go文件或文件列表，则编译为一个个单独的包。

当编译单个main包（文件），则生成可执行文件。

当编译单个或多个包非主包时，只构建编译包，

但丢弃生成的对象（.a）

，仅用作检查包可以构建。

当编译包时，会自动忽略’_test.go’的测试文件。

参数

-o

output 指定编译输出的名称，代替默认的包名。

-i

install 安装作为目标的依赖关系的包(用于增量编译提速)。

以下 build 参数可用在 build, clean, get, install, list, run, test

-a
    完全编译，不理会-i产生的.a文件(文件会比不带-a的编译出来要大？)
-n
    仅打印输出build需要的命令，不执行build动作（少用）。
-p n
    开多少核cpu来并行编译，默认为本机CPU核数（少用）。
-race
    同时检测数据竞争状态，只支持 linux/amd64, freebsd/amd64, darwin/amd64 和 windows/amd64.
-msan
    启用与内存消毒器的互操作。仅支持linux / amd64，并且只用Clang / LLVM作为主机C编译器（少用）。
-v
    打印出被编译的包名（少用）.
-work
    打印临时工作目录的名称，并在退出时不删除它（少用）。
-x
    同时打印输出执行的命令名（-n）（少用）.
-asmflags 'flag list'
    传递每个go工具asm调用的参数（少用）
-buildmode mode
    编译模式（少用）
    'go help buildmode'
-compiler name
    使用的编译器 == runtime.Compiler
    (gccgo or gc)（少用）.
-gccgoflags 'arg list'
    gccgo 编译/链接器参数（少用）
-gcflags 'arg list'
    垃圾回收参数（少用）.
-installsuffix suffix
    ？？？？？？不明白
    a suffix to use in the name of the package installation directory,
    in order to keep output separate from default builds.
    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 'flag list'
    '-s -w': 压缩编译后的体积
    -s: 去掉符号表
    -w: 去掉调试信息，不能gdb调试了
-linkshared
    链接到以前使用创建的共享库
    -buildmode=shared.
-pkgdir dir
    从指定位置，而不是通常的位置安装和加载所有软件包。例如，当使用非标准配置构建时，使用-pkgdir将生成的包保留在单独的位置。
-tags 'tag list'
    构建出带tag的版本.
-toolexec 'cmd args'
    ？？？？？？不明白
    a program to use to invoke toolchain programs like vet and asm.
    For example, instead of running asm, the go command will run
    'cmd args /path/to/asm <arguments for asm>'.

以上命令，单引号/双引号均可。

对包的操作
'go help packages'

对路径的描述
'go help gopath'

对 C/C++ 的互操作
'go help c'

注意

构建遵守某些约定(
'go help gopath'
),但不是所有的项目都遵循这些约定，当使用自己的惯例或使用单独的软件构建系统时可以选择使用较低级别的调用
go tool compile
和
go tool link
来避免一些构建工具的开销和设计决策

go build
的使用比较简洁，所有的参数都可以忽略，直到只有
go build
，这个时候意味着使用当前目录进行编译，下面的几条命令是等价的：

go build

go build .

go build hello.go

以上这三种写法，都是使用当前目录编译的意思。因为我们忽略了
packages
,所以自然就使用当前目录进行编译了。从这里我们也可以推测出，

go build
本质上需要的是一个路径，让编译器可以找到哪些需要编译的go文件。
packages
其实是一个相对路径，是相对于我们定义的
GOROOT
和
GOPATH
这两个环境变量的，所以有了
packages
这个参数后，
go build
就可以知道哪些需要编译的go文件了。

go build flysnow.org/tools

这种方式是指定包的方式，这样会明确地编译我们这个包。当然我们也可以使用通配符

go build flysnow.org/tools/...

3个点表示匹配所有字符串，这样
go build
就会编译tools目录下的所有包。

讲到
go build
编译，不能不提跨平台编译，Go提供了编译链工具，可以让我们在任何一个开发平台上，编译出其他平台的可执行文件。

默认情况下，都是根据我们当前的机器生成的可执行文件，比如你的是Linux 64位，就会生成Linux 64位下的可执行文件，比如我的Mac；可以使用go env查看编译环境,以下截取重要的部分。

复制代码

  ~ go env
GOARCH="amd64"
GOEXE=""
GOHOSTARCH="amd64"
GOHOSTOS="darwin"
GOOS="darwin"
GOROOT="/usr/local/go"
GOTOOLDIR="/usr/local/go/pkg/tool/darwin_amd64"

复制代码

注意里面两个重要的环境变量GOOS和GOARCH,其中GOOS指的是目标操作系统，它的可用值为：

darwin
freebsd
linux
windows
android
dragonfly
netbsd
openbsd
plan9
solaris

一共支持10种操作系统。GOARCH指的是目标处理器的架构，目前支持的有：

arm
arm64
386
amd64
ppc64
ppc64le
mips64
mips64le
s390x

一共支持9种处理器的架构，GOOS和GOARCH组合起来，支持生成的可执行程序种类很多，具体组合参考:

https://golang.org/doc/install/source#environment

如果我们要生成不同平台架构的可执行程序，只要改变这两个环境变量就可以了，比如要生成Linux 64位的程序，命令如下：

GOOS=linux GOARCH=amd64 go build flysnow.org/hello

前面两个赋值，是更改环境变量，这样的好处是只针对本次运行有效，不会更改我们默认的配置。

以上这些用法差不多够我们用的了，更多关于
go build
的用户可以通过以下命令查看:

go help build

参数

-o

-i

以下 build 参数可用在 build, clean, get, install, list, run, test

你可能也喜欢