Go语言支持跨平台交叉编译,通过设置GOOS和GOARCH环境变量指定目标操作系统和CPU架构,如GOOS=linux GOARCH=amd64生成Linux 64位程序,结合CGO_ENABLED=0可生成静态二进制文件用于容器部署,配合shell脚本可批量构建多平台可执行文件,实现“一次编写,到处运行”。

Go语言原生支持跨平台交叉编译,无需额外依赖工具链即可生成不同操作系统和架构的可执行文件。只需设置目标平台的环境变量,就能完成编译。下面介绍几种常用的配置方法。
理解 GOOS 和 GOARCH
交叉编译的核心是设置两个关键环境变量:
常见组合示例如下:
GOOS=linux GOARCH=amd64 → 编译 Linux 64位程序GOOS=windows GOARCH=386 → 编译 Windows 32位程序
GOOS=darwin GOARCH=arm64 → 编译 macOS M1 芯片程序
临时设置环境变量进行编译
在命令行中直接指定环境变量,适用于一次性编译任务:
立即学习“go语言免费学习笔记(深入)”;
GOOS=linux GOARCH=amd64 go build -o myapp main.go GOOS=windows GOARCH=amd64 go build -o myapp.exe main.go GOOS=darwin GOARCH=arm64 go build -o myapp main.go
这种方式不会影响当前系统的默认构建环境,适合 CI/CD 流程或快速打包多平台版本。
跨平台静态链接注意事项
若目标平台不支持动态链接库(如 Alpine Linux),需禁用 CGO 并生成静态二进制文件:
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -a -o myapp main.go
- CGO_ENABLED=0:关闭 CGO,避免依赖本地 C 库
- -a:强制重新编译所有包,确保完整性
这对容器化部署尤其重要,能保证程序在精简镜像中正常运行。
批量构建脚本示例
可通过 shell 脚本一键生成多个平台的可执行文件:
#!/bin/bash
build() {
GOOS=$1 GOARCH=$2 CGO_ENABLED=0 go build -o build/$3 main.go
}
build linux amd64 myapp-linux-amd64
build windows amd64 myapp-windows-amd64.exe
build darwin amd64 myapp-darwin-amd64
build darwin arm64 myapp-darwin-arm64
将上述脚本保存为 build.sh,赋予执行权限后运行,自动输出到 build 目录。
基本上就这些。Go 的交叉编译机制简单高效,配合自动化脚本能轻松实现“一次编写,到处运行”。只要注意 CGO 和依赖项的兼容性,大多数项目都能顺利跨平台构建。










