Go原生支持交叉编译，但需目标GOOS/GOARCH被官方支持且禁用cgo；通过go tool dist list查看支持列表，CGO_ENABLED=0确保静态链接，file/lipo/dumpbin等工具验证二进制兼容性。
Go 原生支持交叉编译，不需要额外安装工具链或配置 CGO_ENABLED=0 就能生成目标平台的二进制——但前提是目标平台的 GOOS 和 GOARCH 组合被 Go 官方支持，且你没在代码里调用 cgo。
确认目标平台是否被 Go 原生支持
不是所有 GOOS/GOARCH 组合都默认可用。比如 linux/arm64、windows/amd64、darwin/arm64 是稳定支持的；而 linux/mips64le 或 freebsd/386 可能仅在较新版本中支持，或需启用实验性功能。
- 运行
go tool dist list查看当前 Go 版本支持的所有平台组合（输出是纯文本列表，每行一个GOOS/GOARCH） - 若目标平台不在列表中，升级 Go 到最新稳定版再试；某些组合（如
ios/arm64）需搭配 Xcode 工具链且不支持纯命令行构建 -
darwin/arm64在 Go 1.16+ 才正式支持，旧版本会报build constraints exclude all Go files
禁用 cgo 是交叉编译干净性的关键
只要代码或依赖中用了 cgo（比如调用 net 包的 DNS 解析、os/user、或任何带 // #include 的文件），默认会尝试链接宿主机的 C 库，导致交叉编译失败或运行时 panic。
- 最稳妥方式：编译时显式关闭 cgo：
CGO_ENABLED=0 go build -o myapp-linux-amd64 - 若必须用 cgo（如需要系统 DNS、OpenSSL），就得为每个目标平台准备对应 C 工具链（如
aarch64-linux-gnu-gcc），并设置CC_aarch64_linux_gnu等环境变量——这已脱离“纯 Go 交叉编译”范畴 - 检查是否隐式启用了 cgo：运行
go env CGO_ENABLED，生产环境建议始终设为0
正确设置 GOOS 和 GOARCH 环境变量
这两个变量决定输出二进制的目标操作系统和架构，必须成对使用，且大小写敏感（GOOS=linux ✅，GOOS=Linux ❌）。
立即学习“go语言免费学习笔记（深入）”；
- 常见组合示例：
GOOS=linux GOARCH=amd64 go build -o app-linux-amd64 GOOS=windows GOARCH=arm64 go build -o app-windows-arm64.exe GOOS=darwin GOARCH=arm64 go build -o app-darwin-arm64
- ARM 架构注意区分：
arm（32 位，需额外指定GOARM=7）、arm64（64 位，无需额外参数） - 不要混用不匹配的组合，例如
GOOS=windows GOARCH=arm在 Go 1.21+ 已废弃，会报错unsupported GOOS/GOARCH pair
交叉编译后验证二进制兼容性
生成的文件看起来能跑，不代表真能跑。尤其 Windows 和 macOS 二进制容易因路径、权限、动态链接问题在目标机上失败。
- Linux 下用
file app-linux-amd64确认是静态链接的 ELF（含statically linked字样）；若显示dynamically linked，说明 cgo 被意外启用 - Windows 下用
file app.exe（WSL 或 Linux 主机）看是否为 PE32+，或直接丢到 Windows 上用dumpbin /headers app.exe查看机器类型 - macOS 上用
lipo -info app-darwin-arm64确认是arm64架构；若提示non-fat file，说明不是通用二进制（正常）
真正麻烦的是那些没报错但运行时崩溃的情况：比如用 os.UserHomeDir() 在 Windows 交叉编译后返回空字符串（因底层调用了 cgo），或者日志里出现 fork/exec /bin/sh: no such file or directory（因硬编码了 Linux 路径）。这些不会在 build 阶段暴露，得靠目标平台实测。
