Go跨平台交叉编译成功的关键是同时显式设置GOOS和GOARCH，并关闭CGO_ENABLED=0；漏设任一变量或启用CGO，易导致目标机器报cannot execute binary file或no such file or directory。
GOOS 和 GOARCH 设置对了，就能在 macOS 或 Linux 上直接编译出 Windows、ARM Linux 甚至 Android 的可执行文件——不需要虚拟机、不用装双系统、不依赖外部工具链。但错一个字母、漏一个环境变量，或者没关 CGO_ENABLED，生成的二进制就可能在目标机器上直接报 Exec format error 或 cannot load system library。
怎么用 go build 做最简交叉编译
核心就是三要素：目标操作系统（GOOS）、目标架构（GOARCH）、是否启用 C 语言调用（CGO_ENABLED）。缺一不可，顺序无关。
常见组合示例：
GOOS=linux GOARCH=amd64 go build -o app-linux-amd64 main.go-
GOOS=windows GOARCH=amd64 go build -o app-win-amd64.exe main.go（注意后缀.exe） -
GOOS=darwin GOARCH=arm64 go build -o app-macos-arm64 main.go（M1/M2 Mac 适用） -
GOOS=linux GOARCH=arm64 GOARM=7 go build -o app-linux-armv7 main.go（ARMv7 需额外设GOARM）
不加 CGO_ENABLED=0 时，若代码里用了 net、os/user 等包，Go 会悄悄启用 cgo，导致链接 libc —— 这在 Alpine 容器或嵌入式设备上直接失败。
为什么 CGO_ENABLED=0 几乎总是必须的
启用 cgo 后，Go 编译器会动态链接系统 C 库（如 glibc 或 musl），而目标平台未必有对应版本，甚至根本没装 C 运行时。静态编译才是跨平台部署的默认安全线。
立即学习“go语言免费学习笔记（深入）”；
典型错误现象：
- Linux ARM64 设备上运行报
./app: not found（其实是动态库缺失，不是文件不存在） - Docker Alpine 镜像中启动失败，日志显示
error while loading shared libraries: libpthread.so.0: cannot open shared object file - Windows 上生成的二进制在旧版系统（如 Win7）闪退，因依赖新版 UCRT
正确做法是显式关闭：
CGO_ENABLED=0 GOOS=linux GOARCH=arm64 go build -a -o app main.go
其中 -a 强制重编所有依赖，避免缓存中混入带 cgo 的包。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
Windows 32 位和 ARM 架构的特殊处理
Go 官方支持 GOARCH=386（x86 32 位），但 Windows 上有个隐藏前提：Go 必须是从源码构建的，否则 go build 会静默忽略 GOARCH=386 并继续生成 64 位程序。
验证方式：
- 运行
go env GOARCH，确认输出不是amd64 - 检查
%GOROOT%\pkg\tool\*\下是否存在dist工具链支持windows_386
ARM 架构则要区分：
-
GOARCH=arm64：对应 AArch64（如树莓派 4/5、AWS Graviton、M1 Mac） -
GOARCH=arm GOARM=7：对应 ARMv7（如旧款树莓派 2/3、部分安卓设备） -
GOARCH=arm GOARM=6：极少数嵌入式场景，需确认 Go 版本是否仍支持（1.21+ 已弃用）
ARM 编译失败时，先运行 go tool dist list | grep arm 查看当前 Go 版本能识别的目标列表。
用 Docker 避免本地环境污染
当项目必须用 cgo（比如调用 SQLite 或 OpenSSL），又需要交叉编译时，本地环境很难配齐所有交叉 C 工具链（如 aarch64-linux-gnu-gcc）。这时 Docker 是更稳的选择。
推荐两种轻量方案：
- 用官方
golang:alpine镜像 +apk add gcc musl-dev，再跑CGO_ENABLED=1 GOOS=linux GOARCH=arm64 go build - 用社区成熟的
xgo镜像：docker run --rm -v $(pwd):/src -w /src karalabe/xgo-latest --targets=linux/arm64,windows/amd64 .
注意：xgo 默认启用 cgo，且会自动下载对应平台的 Go 源码和工具链，首次运行较慢；但它能绕过本地 Go 安装限制，比如在 macOS 上直接编译 iOS 目标（需额外证书配置）。
真正容易被忽略的点是：交叉编译生成的二进制，无法在宿主机上直接 file 或 ldd 验证——必须上传到目标机器，或用 qemu-user-static 注册后在本地模拟执行，否则你永远不知道它是不是真能跑。
