go跨平台交叉编译成功的关键是同时显式设置goos和goarch并关闭cgo_enabled=0；漏设任一变量或启用cgo，易导致目标机器报cannot execute binary file或no such file or directory。
不需要装额外工具链、不改系统环境变量、不碰 Docker，Golang 交叉编译就能跑起来——前提是你要清楚 GOOS 和 GOARCH 是什么，以及为什么 CGO_ENABLED=0 不是可选项而是默认安全线。
GOOS/GOARCH 组合怎么查、怎么选
别靠记忆或搜“常见组合”，直接运行 go tool dist list，它会输出所有当前 Go 版本原生支持的目标平台。输出里每一行都是 os/arch 格式（比如 linux/amd64、windows/arm64），中间用斜杠分隔，不是下划线也不是空格。
-
GOOS必须严格匹配列表中的操作系统名：linux、windows、darwin、freebsd等，写成win或mac会静默失败 -
GOARCH同理：amd64、arm64、386、arm—— 注意 ARMv7 需额外设GOARM=7，而 M1/M2 Mac 编译目标为arm64时，GOARCH就是arm64，不是arm - ARM 架构若漏设
GOARM（仅当GOARCH=arm时需要），编译会成功但二进制在目标设备上 panic：runtime: unknown architecture
CGO_ENABLED=0 是静态编译的底线
只要没显式调用 C 代码（比如 #include、C.xxx 调用、或依赖含 cgo 的第三方包如 net 某些 DNS 解析逻辑），就该强制关掉 CGO。否则生成的二进制可能依赖目标系统上的 libc 或 libpthread，一丢到 Alpine 容器或嵌入式 Linux 就报 not found。
- Windows 和 macOS 默认禁用 CGO，Linux 下常默认启用，所以跨平台时务必显式加
CGO_ENABLED=0 - 即使项目里没写 C 代码，某些标准库（如
os/user、net）在 Linux 下会悄悄启用 CGO；加-a参数可强制重编译所有依赖，避免缓存残留 - 命令示例：
CGO_ENABLED=0 GOOS=linux GOARCH=arm64 go build -a -o app-linux-arm64 main.go
多工程交叉编译不用写脚本也能一次搞定
如果你有多个 main 包分散在不同目录（比如 cmd/api、cmd/worker、cmd/cli），又不想每个都手动敲一遍环境变量，可以用 Go 的模块路径自动识别能力：
- 确保根目录有
go.mod，且各子命令目录都以package main开头 - 用
go list ./cmd/...列出所有可执行入口，再配合xargs批量编译：go list ./cmd/... | xargs -I {} sh -c 'CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o bin/{}-linux-amd64 {}' - 注意：
{}是go list输出的完整导入路径（如example.com/cmd/api），不是文件名；输出二进制名需自行截取或用basename处理 - Windows 下 PowerShell 不支持
xargs，改用ForEach-Object或直接写 for 循环
编译后二进制怎么验证是不是真能跑
别急着上传服务器，本地就能快速验真假：
- Linux 目标：用
file app-linux-amd64看是否含ELF 64-bit LSB executable, x86-64，再用ldd app-linux-amd64—— 如果显示not a dynamic executable，说明静态链接成功；若列出一堆libc.so.6，就是 CGO 没关干净 - Windows 目标：Mac/Linux 上无法运行，但可用
file app-windows-amd64.exe确认是PE32+ executable (console) x86-64 - ARM64 目标：
qemu-aarch64-static ./app-linux-arm64可模拟运行（需安装qemu-user-static），比上传再调试快得多
真正容易被忽略的是：Go 编译器对 GOOS/GOARCH 的大小写和拼写零容忍，错一个字符就回退到宿主平台；而 CGO_ENABLED=0 这个开关一旦漏掉，在 CI 环境里可能只在某几个 OS 上暴露问题，等上线才发现已晚。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
