Go 语言以其强大的跨平台能力而著称，其内置的工具链使得构建适配不同平台的二进制可执行文件变得非常简单。在本章中，我们将详细讲解跨平台构建的基本概念、环境变量的配置方法、如何构建适配不同平台的二进制文件，以及相关的注意事项。
1、跨平台构建的基本概念
Go 的编译器支持将源代码直接编译为适配不同操作系统和架构的二进制文件。通过设置特定的环境变量，开发者可以快速为不同的目标平台生成可执行文件，而无需在目标平台上单独配置开发环境。
常见目标平台
1. 操作系统： - Linux - Windows - macOS - FreeBSD 等
2. CPU 架构： - amd64 (x86-64) - 386 (x86) - arm (ARM 32-bit) - arm64 (ARM 64-bit)
2、环境变量的配置
跨平台构建主要依赖以下两个环境变量：
1. GOOS：目标操作系统。
2. GOARCH：目标 CPU 架构。
常见配置值
| 环境变量 | 可选值 | 说明 |
| GOOS | `linux`, `windows`, `darwin`, `freebsd` 等 | 目标操作系统 |
| GOARCH | `amd64`, `386`, `arm`, `arm64` | 目标 CPU 架构 |
3、构建跨平台二进制文件
基本语法
GOOS=<目标操作系统> GOARCH=<目标架构> go build -o <输出文件名> <源文件>
示例 1：构建适配 Linux 平台的二进制文件
假设项目目录中有 main.go 文件：
GOOS=linux GOARCH=amd64 go build -o myapp-linux main.go
生成的二进制文件 myapp-linux 可直接在 Linux x86-64 环境中运行。
示例 2：构建适配 Windows 平台的二进制文件
GOOS=windows GOARCH=amd64 go build -o myapp.exe main.go
生成的 myapp.exe 可直接在 Windows x86-64 环境中运行。
示例 3：构建适配 ARM 架构的二进制文件
GOOS=linux GOARCH=arm64 go build -o myapp-arm64 main.go
适用于 ARM 64 位架构的设备，例如树莓派。
4、批量构建多个平台的二进制文件
通过脚本可以批量构建多个平台的二进制文件。以下是一个示例 Bash 脚本：
!/bin/bash
PLATFORMS=("linux/amd64" "windows/amd64" "darwin/amd64" "linux/arm64")
OUTPUT="myapp"
for PLATFORM in "${PLATFORMS[@]}"do
OS=$(echo $PLATFORM | cut -d'/' -f1)
ARCH=$(echo $PLATFORM | cut -d'/' -f2)
OUTPUT_NAME=${OUTPUT}-${OS}-${ARCH}
if [ "$OS" == "windows" ]; then
OUTPUT_NAME+='.exe'
fi
GOOS=$OS GOARCH=$ARCH go build -o $OUTPUT_NAME main.go
echo "Built $OUTPUT_NAME"done运行该脚本后，生成的二进制文件会适配多个平台。
5、使用 CGO_ENABLED 控制跨平台构建
默认情况下，Go 编译器会使用 cgo 绑定 C 语言库，但在跨平台构建时，cgo 可能引入额外的复杂性。可以通过设置 CGO_ENABLED 环境变量禁用 cgo：
禁用 cgo
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o myapp-static main.go
生成的二进制文件是静态链接的，适合在目标平台运行时无外部依赖。
6、注意事项
依赖系统库的代码可能不兼容： 如果代码中依赖了某些系统库（例如 C 库），需要确保目标平台的库兼容性，或者使用静态编译。
动态库加载问题： 在禁用 cgo 时，动态库的加载可能失效，建议切换到纯 Go 的实现。
文件路径差异： 在不同操作系统之间，文件路径分隔符 (/ vs \) 可能导致兼容性问题。建议使用 path/filepath 包处理路径。
脚本自动化： 在项目中集成自动化脚本，确保每次发布都生成所有目标平台的二进制文件。
测试环境： 即使成功构建二进制文件，仍需在目标平台中进行实际测试，验证功能和性能是否符合预期。