Go原生支持交叉编译,只需设置GOOS和GOARCH;默认CGO_ENABLED=0时零依赖,启用cgo后需目标平台的交叉C工具链及对应头文件和库。

Go 原生支持交叉编译,不需要额外安装工具链或配置复杂环境 —— 只要设置好 GOOS 和 GOARCH,就能直接生成目标平台的二进制文件。
为什么不用配 C 交叉工具链?
Go 标准库几乎全部用 Go 实现(net、os、time 等),仅少数底层调用(如系统调用封装)依赖 C。只要不使用 cgo,就完全绕过本地 C 编译器;启用 cgo 后才需对应平台的 CC 工具链。
- 默认
CGO_ENABLED=0,此时交叉编译零依赖 - 若项目用了
import "C"或依赖含 C 代码的包(如sqlite3、openssl),必须设CGO_ENABLED=1并提供目标平台的CC -
CC不是随便装个 gcc 就行 —— 必须是目标平台的交叉编译器,例如aarch64-linux-gnu-gcc编译 Linux ARM64
常用 GOOS/GOARCH 组合与验证方式
先确认本机 Go 支持哪些目标平台:
go tool dist list
输出中包含所有合法组合,例如:
立即学习“go语言免费学习笔记(深入)”;
-
linux/amd64(默认,通常无需设置) -
darwin/arm64(macOS M 系列芯片) windows/amd64linux/arm64-
linux/386(32 位 x86,注意 Go 1.21+ 已标记为 deprecated)
编译时直接传入环境变量:
GOOS=windows GOARCH=amd64 go build -o app.exe main.go
生成的 app.exe 可在 Windows 上直接运行,无需 Windows 环境。
android内核编译手册(图文并茂) chm,Google Android操作系统内核编译图文教程。 搭建交叉编译环境(安装Android SDK: 将android-sdk_m5-rc14_linux-x86.zip解压缩到适当路径下即可使用。本文将其释放至/usr/local/android_sdk_linux路径下,并将其tools路径添加到PATH中),获取内核编译配置文件(从android sdk 中的模拟器中得到。启动android模拟器,再通过adb得到模拟器中提供的内核配置文件),在
启用 CGO 时的交叉编译要点
一旦设了 CGO_ENABLED=1,Go 就会调用 $CC 编译 C 代码,此时必须确保:
-
CC环境变量指向正确的交叉编译器(如CC=aarch64-linux-gnu-gcc) - 交叉编译器已安装且在
$PATH中(Ubuntu/Debian:安装gcc-aarch64-linux-gnu包) - 头文件和链接库路径正确(常需通过
CGO_CFLAGS和CGO_LDFLAGS指定) - 避免混用主机与目标平台的 C 库(例如在 macOS 上用
clang编译 Linux 二进制会失败)
典型 Linux ARM64 编译命令:
CGO_ENABLED=1 CC=aarch64-linux-gnu-gcc GOOS=linux GOARCH=arm64 go build -o app-arm64 main.go
Docker 是最稳妥的多平台构建方案
本地装一堆交叉工具链容易冲突,尤其涉及不同 libc(glibc vs musl)或版本差异时。推荐用官方 golang 镜像按需构建:
docker run --rm -v $(pwd):/work -w /work golang:1.22-alpine go build -o app-linux-amd64 -ldflags="-s -w" main.go
Alpine 镜像默认 CGO_ENABLED=0,适合纯 Go 项目;若需 cgo,改用 golang:1.22(Debian base)并安装对应 gcc-* 包。
真正麻烦的从来不是 GOOS/GOARCH 这两个变量,而是隐式依赖的 C 生态 —— 一旦项目引入了 net 以外的系统级能力(DNS 解析策略、证书验证、时区数据),就可能触发 libc 行为差异,这时光靠交叉编译不够,得实机测试。









