Go跨平台交叉编译成功的关键是同时显式设置GOOS和GOARCH，并关闭CGO_ENABLED=0；漏设任一变量或启用CGO，易导致目标机器报cannot execute binary file或no such file or directory。
Go 二进制可直接跨平台运行，但编译前必须明确目标环境的 GOOS 和 GOARCH，且绝大多数情况下需禁用 CGO_ENABLED=0 —— 否则生成的二进制仍依赖目标系统上的 libc 等动态库，失去“开箱即用”优势。
确认本地 Go 环境是否支持目标平台
不是所有 Go 安装都默认支持全部 GOOS/GOARCH 组合。比如 Windows 上预编译的 Go 安装包（非源码构建）默认不带 windows/386 工具链；macOS M1 机器默认也不含 linux/arm64 的标准库缓存（虽能编译，但首次会慢）。
- 运行
go tool dist list查看当前 Go 安装支持的所有平台组合，输出类似linux/amd64、darwin/arm64、windows/amd64 - 若目标组合（如
windows/386）不在列表中，且你用的是预编译安装包，则无法直接交叉编译——必须从源码构建 Go，再执行make.bat（Windows）或make.bash（macOS/Linux）补全对应平台工具链 - Mac M1 用户想编译
linux/arm64，首次运行时会自动下载对应标准库，无需手动准备；但若要确保离线可用，可提前执行GOOS=linux GOARCH=arm64 go list std
交叉编译命令必须设对三个关键环境变量
只改 GOOS 或只改 GOARCH 是常见错误。真正生效的是三者共同作用：GOOS（操作系统）、GOARCH（CPU 架构）、CGO_ENABLED（是否启用 C 调用）。漏掉任一，都可能导致运行失败或行为异常。
-
CGO_ENABLED=0是绝大多数服务端程序的刚需：它让 Go 链接器使用纯 Go 实现的 net、os、time 等包，避免依赖目标系统 glibc/musl；一旦启用（默认为 1），GOOS=linux GOARCH=arm64编出的二进制在 Alpine 容器里大概率报no such file or directory -
GOOS=windows时，输出文件名建议加.exe后缀（如-o app.exe），否则 Windows 双击无法识别；而GOOS=linux时不能加后缀，否则 Linux 下./app.exe会被当成普通文件而非可执行文件 - 参数顺序无关紧要，但环境变量必须前置：写成
GOOS=linux CGO_ENABLED=0 go build -o bin/app .正确；写成go build -o bin/app . GOOS=linux无效
Makefile 中管理多平台编译容易忽略路径和模块一致性
Makefile 里写 GOOS=linux go build -o bin/app . 看似简洁，但实际执行时工作目录若不是 go.mod 所在根目录，就会触发 cannot find module 错误——因为 Go 不会向上递归查找 go.mod，只认当前目录或显式指定的模块路径。
立即学习“go语言免费学习笔记（深入）”；
- 必须先切到项目根目录：用
cd $$(shell dirname $$(realpath $$(firstword $$(MAKEFILE_LIST)))) &&确保后续命令在正确位置执行 - 不要用
go build .，而应显式指定主包路径，例如go build -o bin/app ./cmd/app，避免意外编译测试文件或内部包 - 若需注入版本号，
-ldflags中的-X参数值必须与代码中变量声明完全匹配，比如main.version对应var version string，写成app.version会静默失效
Windows 上编译 32 位程序要额外准备工具链
64 位 Windows 上的预装 Go 默认只带 windows/amd64 工具链，GOARCH=386 不会自动生效，强行执行只会编出 amd64 架构的二进制（哪怕 file app.exe 显示 PE32，实际仍是 64 位）。
- 必须从 Go 源码构建：下载
go/src，进入%GOROOT%\src，执行set GOARCH=386 && make.bat --no-clean - 每次新开 CMD/PowerShell 都要重新
set GOARCH=386，除非设为系统级环境变量；PowerShell 中用$env:GOARCH="386" - 验证是否成功：编译后用
dumpbin /headers app.exe | findstr "machine"（Windows SDK 工具），输出含x86而非AMD64才算真正 32 位
最易被忽略的一点：CGO_ENABLED=0 不仅影响 libc 依赖，还会让 net 包回退到纯 Go DNS 解析器（不读取 /etc/resolv.conf），在某些内网环境可能解析失败；若必须用系统 DNS，就得保留 CGO_ENABLED=1 并确保目标系统有对应 libc，此时已不属于“零依赖部署”范畴。
