Go自带交叉编译支持,只需设置GOOS和GOARCH环境变量并确认目标平台已启用;使用go tool dist list可查看所有支持组合,cgo例外需额外C工具链。

手动搭建 Golang 交叉编译环境并不需要额外安装工具链,Go 自身已内置多平台支持,关键在于正确设置 GOOS 和 GOARCH 环境变量,并确认目标平台的构建支持是否已启用。
确认 Go 版本与内置支持平台
从 Go 1.5 开始,官方默认开启对主流操作系统的交叉编译支持(如 linux/amd64、windows/arm64、darwin/arm64 等),无需下载额外 SDK 或 C 工具链(除非使用 cgo)。可通过以下命令查看当前 Go 支持的所有目标组合:
-
go tool dist list—— 列出所有可编译的目标平台(如linux/arm64、windows/amd64、darwin/arm64) -
go env GOOS GOARCH—— 查看当前主机默认平台
设置交叉编译变量并构建
只需在构建时指定目标平台环境变量,Go 编译器会自动切换输出格式。例如:
- 编译为 Linux ARM64 可执行文件:
GOOS=linux GOARCH=arm64 go build -o myapp-linux-arm64 main.go - 编译为 Windows AMD64 程序:
GOOS=windows GOARCH=amd64 go build -o myapp.exe main.go - 编译为 macOS Apple Silicon(M1/M2)程序:
GOOS=darwin GOARCH=arm64 go build -o myapp-darwin-arm64 main.go
注意:若项目中使用了 cgo(比如调用 C 库),则需对应平台的 C 编译器(如 aarch64-linux-gnu-gcc)和头文件,此时才需手动配置 CC_FOR_TARGET 或交叉工具链。
立即学习“go语言免费学习笔记(深入)”;
android内核编译手册(图文并茂) chm,Google Android操作系统内核编译图文教程。 搭建交叉编译环境(安装Android SDK: 将android-sdk_m5-rc14_linux-x86.zip解压缩到适当路径下即可使用。本文将其释放至/usr/local/android_sdk_linux路径下,并将其tools路径添加到PATH中),获取内核编译配置文件(从android sdk 中的模拟器中得到。启动android模拟器,再通过adb得到模拟器中提供的内核配置文件),在
处理依赖与模块兼容性
交叉编译时,Go Modules 不受影响,但要注意以下几点:
- 确保
go.mod中的 Go 版本不低于目标平台所需(如 darwin/arm64 需 Go 1.16+) - 避免在代码中硬编码平台相关路径或行为(如用
runtime.GOOS做条件分支时,要确认逻辑在目标平台也成立) - 如需静态链接(尤其部署到 Alpine Linux),添加
-ldflags '-s -w -extldflags "-static"'
验证与调试小技巧
编译完成后,可用系统命令快速验证目标平台信息:
- Linux/macOS 下:
file myapp-linux-arm64(应显示ELF 64-bit LSB executable, ARM aarch64) - Windows 下可用
dumpbin /headers myapp.exe(需 Visual Studio 工具)或第三方工具如PE-bear - 在目标机器上直接运行前,先检查权限(Linux/macOS):
chmod +x myapp-linux-arm64
基本上就这些。不复杂但容易忽略的是:别被“交叉编译”这个词吓住——Go 天然支持,只要变量设对,一条命令就能出包。









