Go跨平台交叉编译成功的关键是同时显式设置GOOS和GOARCH并关闭CGO_ENABLED=0；漏设任一变量或启用CGO，易导致目标机器报cannot execute binary file或no such file or directory。
Go 本身不依赖虚拟机或运行时环境，跨平台编译能力是原生内置的，只要正确设置 GOOS 和 GOARCH，再关闭 CGO_ENABLED，90% 的项目都能直接生成目标平台二进制文件，无需 Docker、无需交叉工具链、也无需在目标机器上装 Go。
GOOS 和 GOARCH 必须同时显式指定
Go 默认只构建当前宿主机平台的程序（比如在 macOS 上执行 go build，得到的是 darwin/amd64）。想生成其他平台程序，GOOS 和 GOARCH 缺一不可，且必须在 go build 命令前设置。
-
GOOS=linux GOARCH=arm64 go build -o app-linux-arm64 main.go✅ -
GOOS=windows go build -o app.exe main.go❌（缺GOARCH，会报unsupported GOOS/GOARCH pair） -
GOOS=darwin GOARCH=arm64在 Go 1.21+ 才正式支持；旧版本（如 1.19）会失败，可用go tool dist list | grep darwin/arm64验证是否支持 - 常见组合可查：
go tool dist list，输出全是合法的GOOS/GOARCH对，不是靠记忆猜
CGO_ENABLED=0 是稳定跨平台的前提
默认 CGO_ENABLED=1，一旦代码或依赖中含 // #cgo 指令、调用 C 函数、或导入 C 包（如 github.com/mattn/go-sqlite3），交叉编译大概率失败——因为宿主机没有目标平台的 C 头文件和链接器。
- 纯 Go 项目（无 C 依赖）：强制加
CGO_ENABLED=0，生成完全静态二进制，丢到任意同架构 Linux 服务器上就能跑 - 含 C 依赖的项目：不能简单关 CGO，否则编译报错
exec: "gcc": executable file not found in $PATH；此时要么改用 Docker 模拟目标环境，要么只能去目标机器上go build -
CGO_ENABLED=0还能避免 libc 版本兼容问题（比如在 Ubuntu 24.04 编译的二进制，在 CentOS 6 上因 glibc 太旧而无法运行）
Windows 和 macOS 平台的命名与路径细节
跨平台编译不是“只要能编译出来就行”，部署时容易卡在文件名、路径、权限这些细节上。
立即学习“go语言免费学习笔记（深入）”；
- Windows 目标必须加
.exe后缀：GOOS=windows GOARCH=amd64 go build -o client.exe main.go；没后缀的文件在 Windows 上双击无反应 - macOS 程序即使编译成功，若未签名，在 macOS 10.15+ 可能被 Gatekeeper 拦截；临时解决可右键「打开」绕过，但生产环境需 codesign
- 所有平台都建议用
filepath.Join()处理路径，别硬写"config.yaml"或"./data/"；编译不打包资源，配置文件、模板、图片等必须手动随二进制一起分发 - Linux 二进制在 WSL 中可直接运行，但注意：WSL1 不支持
GOOS=linux GOARCH=arm64生成的文件（需 WSL2 + ARM64 内核）
构建脚本里别漏掉 -a 和 -ldflags="-s -w"
日常开发中，缓存和调试信息会让构建结果不可靠或体积过大，尤其交付给客户前。
-
-a强制重编译所有依赖包，避免本地缓存导致某次构建“看似成功”实则用了旧版依赖（例如你升级了golang.org/x/sys，但没加-a，可能仍用旧版） -
-ldflags="-s -w"去掉符号表和调试信息，典型效果：28MB → 19MB；对嵌入式设备或容器镜像大小敏感的场景很实用 - 推荐组合：
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -a -ldflags="-s -w" -o server main.go - PowerShell 用户注意变量赋值语法：
$env:CGO_ENABLED="0"; $env:GOOS="linux"; $env:GOARCH="amd64"，不能写成CGO_ENABLED=0 GOOS=linux ...
最常被忽略的一点：跨平台编译只管生成二进制，它不会检查你的代码里有没有硬编码的路径分隔符、系统命令调用（如 exec.Command("ls")）、或依赖特定 shell 功能（如 bash 数组）。这些逻辑在目标平台可能直接 panic 或静默失败，得靠真实环境验证。
