Golang 交叉编译

知识点

  • 跨平台编译

本文目标

连载九 讲解构建 Scratch 镜像时,我们编译可执行文件用了另外一个形式的命令,如下:

  1. $ CGO_ENABLED=0 GOOS=linux go build -a -installsuffix cgo -o go-gin-example .

我想你可能会有疑问,今天本文会针对这块进行讲解。

说明

我们将讲解命令各个参数的作用,希望你在阅读时,将每一项串联起来,你会发现这就是交叉编译相关的小知识

也就是 Golang 令人心动的特性之一跨平台编译

一、CGO_ENABLED

作用:

用于标识(声明) cgo 工具是否可用

意义:

存在交叉编译的情况时,cgo 工具是不可用的。在标准 go 命令的上下文环境中,交叉编译意味着程序构建环境的目标计算架构的标识与程序运行环境的目标计算架构的标识不同,或者程序构建环境的目标操作系统的标识与程序运行环境的目标操作系统的标识不同

小结:

结合案例来说,我们是在宿主机编译的可执行文件,而在 Scratch 镜像运行的可执行文件;显然两者的计算机架构、运行环境标识你无法确定它是否一致(毕竟构建的 docker 镜像还可以给他人使用),那么我们就要进行交叉编译,而交叉编译不支持 cgo,因此这里要禁用掉它

关闭 cgo 后,在构建过程中会忽略 cgo 并静态链接所有的依赖库,而开启 cgo 后,方式将转为动态链接

补充:

golang 是默认开启 cgo 工具的,可执行 go env 命令查看

  1. $ go env
  2. GOARCH="amd64"
  3. GOBIN=""
  4. GOCACHE="/root/.cache/go-build"
  5. GOEXE=""
  6. GOHOSTARCH="amd64"
  7. GOHOSTOS="linux"
  8. GOOS="linux"
  9. ...
  10. GCCGO="gccgo"
  11. CC="gcc"
  12. CXX="g++"
  13. CGO_ENABLED="1"
  14. ...

二、GOOS

用于标识(声明)程序构建环境的目标操作系统

如:

  • linux
  • windows

三、GOARCH

用于标识(声明)程序构建环境的目标计算架构

若不设置,默认值与程序运行环境的目标计算架构一致(案例就是采用的默认值)

如:

  • amd64
  • 386
系统 GOOS GOARCH
Windows 32 位 windows 386
Windows 64 位 windows amd64
OS X 32 位 darwin 386
OS X 64 位 darwin amd64
Linux 32 位 linux 386
Linux 64 位 linux amd64

四、GOHOSTOS

用于标识(声明)程序运行环境的目标操作系统

五、GOHOSTARCH

用于标识(声明)程序运行环境的目标计算架构

六、go build

-a

强制重新编译,简单来说,就是不利用缓存或已编译好的部分文件,直接所有包都是最新的代码重新编译和关联

-installsuffix

作用:

在软件包安装的目录中增加后缀标识,以保持输出与默认版本分开

补充:

如果使用 -race 标识,则后缀就会默认设置为 -race 标识,用于区别 race 和普通的版本

-o

指定编译后的可执行文件名称

小结

大部分参数指令,都有一定关联性,且与交叉编译的知识点相关,可以好好品味一下

最后可以看看 go build help 加深了解

  1. $ go help build
  2. usage: go build [-o output] [-i] [build flags] [packages]
  3. ...
  4. -a
  5. force rebuilding of packages that are already up-to-date.
  6. -n
  7. print the commands but do not run them.
  8. -p n
  9. the number of programs, such as build commands or
  10. test binaries, that can be run in parallel.
  11. The default is the number of CPUs available.
  12. -race
  13. enable data race detection.
  14. Supported only on linux/amd64, freebsd/amd64, darwin/amd64 and windows/amd64.
  15. -msan
  16. enable interoperation with memory sanitizer.
  17. Supported only on linux/amd64,
  18. and only with Clang/LLVM as the host C compiler.
  19. -v
  20. print the names of packages as they are compiled.
  21. -work
  22. print the name of the temporary work directory and
  23. do not delete it when exiting.
  24. -x
  25. print the commands.
  26. -asmflags '[pattern=]arg list'
  27. arguments to pass on each go tool asm invocation.
  28. -buildmode mode
  29. build mode to use. See 'go help buildmode' for more.
  30. -compiler name
  31. name of compiler to use, as in runtime.Compiler (gccgo or gc).
  32. -gccgoflags '[pattern=]arg list'
  33. arguments to pass on each gccgo compiler/linker invocation.
  34. -gcflags '[pattern=]arg list'
  35. arguments to pass on each go tool compile invocation.
  36. -installsuffix suffix
  37. a suffix to use in the name of the package installation directory,
  38. in order to keep output separate from default builds.
  39. If using the -race flag, the install suffix is automatically set to race
  40. or, if set explicitly, has _race appended to it. Likewise for the -msan
  41. flag. Using a -buildmode option that requires non-default compile flags
  42. has a similar effect.
  43. -ldflags '[pattern=]arg list'
  44. arguments to pass on each go tool link invocation.
  45. -linkshared
  46. link against shared libraries previously created with
  47. -buildmode=shared.
  48. -pkgdir dir
  49. install and load all packages from dir instead of the usual locations.
  50. For example, when building with a non-standard configuration,
  51. use -pkgdir to keep generated packages in a separate location.
  52. -tags 'tag list'
  53. a space-separated list of build tags to consider satisfied during the
  54. build. For more information about build tags, see the description of
  55. build constraints in the documentation for the go/build package.
  56. -toolexec 'cmd args'
  57. a program to use to invoke toolchain programs like vet and asm.
  58. For example, instead of running asm, the go command will run
  59. 'cmd args /path/to/asm <arguments for asm>'.
  60. ...

参考

本系列示例代码

书籍

  • Go 并发编程实战 第二版

关于

修改记录

  • 第一版:2018 年 02 月 16 日发布文章
  • 第二版:2019 年 10 月 01 日修改文章

如果有任何疑问或错误,欢迎在 issues 进行提问或给予修正意见,如果喜欢或对你有所帮助,欢迎 Star,对作者是一种鼓励和推进。

我的公众号

image