go跨平台交叉编译成功的关键是同时显式设置goos和goarch并关闭cgo_enabled=0；漏设任一变量或启用cgo，易导致目标机器报cannot execute binary file或no such file or directory。
Go 本身不依赖目标平台的 SDK 或工具链，只要代码没硬编码系统调用、没滥用构建约束，就能直接跨平台编译；但 GOOS 和 GOARCH 必须同时显式设置，CGO_ENABLED=0 是多数场景下最稳妥的默认开关。
GOOS 和 GOARCH 必须成对出现，不能只设一个
单独设置 GOOS=linux 而不设 GOARCH，Go 会沿用当前机器的架构（比如 macOS 上是 arm64），结果可能不是你想要的 linux/amd64。同样，只设 GOARCH=arm64 不设 GOOS，可能产出 darwin/arm64（macOS）而非 linux/arm64。
- 查所有合法组合：运行
go tool dist list - 常见组合示例：
GOOS=linux GOARCH=amd64、GOOS=windows GOARCH=386、GOOS=darwin GOARCH=arm64 - ARM32 需额外加
GOARM=7（如树莓派 Zero） - Windows 输出建议加
.exe后缀，否则双击打不开
CGO_ENABLED=0 不是万能解药，但它是默认安全线
关闭 CGO 后，Go 会跳过所有 // #cgo 指令、不链接 C 库、也不调用系统 libc —— 这让二进制彻底静态，部署到任意 Linux 容器或嵌入式设备都无需担心 libc.so.6 版本问题。但代价是部分标准库行为会降级：
-
net包改用纯 Go DNS 解析，忽略/etc/resolv.conf和systemd-resolved -
user.Current()可能返回空或 panic，因无法调用getpwuid_r - 若项目用了
github.com/mattn/go-sqlite3或cgo加密库，CGO_ENABLED=0直接编译失败 - 错误现象：
exec: "gcc": executable file not found in $PATH就是 CGO 开着但没配交叉编译器
必须用 CGO 时，别在本地硬配，优先走 Docker
在 macOS 上给 Linux ARM64 编译含 CGO 的程序，要配齐 aarch64-linux-gnu-gcc、头文件路径、libssl 等交叉依赖，极易漏项且难调试。Docker 提供了干净隔离的环境：
- 推荐镜像：
golang:1.22-alpine或arm64v8/golang:1.22 - 命令示例：
docker run --rm -v $(pwd):/work -w /work arm64v8/golang:1.22 sh -c "CGO_ENABLED=1 GOOS=linux GOARCH=arm64 go build -o app ." - 若需特定 C 库（如 OpenSSL），在 Dockerfile 中
apk add openssl-dev或apt-get install libssl-dev - 避免在宿主机 export CC 或修改全局环境变量，CI 脚本里极易污染后续步骤
构建脚本里别用 export，用 env 前置更可靠
写自动化脚本时，用 export GOOS=xxx 会让变量持续生效，一旦中间出错或中断，后续终端命令可能意外继承错误平台设置。Mac 用户尤其容易被 zsh 的环境继承机制坑到。
- 正确写法：
env GOOS=linux GOARCH=arm64 CGO_ENABLED=0 go build -o app-linux-arm64 . - 错误写法：
export GOOS=linux; export GOARCH=arm64; go build -o app .（变量残留风险高） - 多平台批量构建时，用循环包裹
env，而不是先 export 再循环 - Windows 上 PowerShell 不支持
env VAR=val cmd语法，得用$env:GOOS="linux"; $env:GOARCH="amd64"; go build ...，建议统一用 CI 脚本或 WSL 执行
真正麻烦的从来不是编译本身，而是编译出来的二进制在目标机上跑不起来——比如 DNS 解析失败、用户信息读不到、或者一启动就 panic: runtime error: invalid memory address。这些问题往往和 CGO 的开关状态、标准库的隐式依赖、甚至 go.mod 里某个间接依赖的构建标签有关，得靠真实环境验证，不能只信本地 file app-linux-arm64 显示 “ELF 64-bit LSB executable” 就算完事。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
