本文详解如何在 macos 上正确交叉编译 go 程序为目标 linux（amd64）平台，避免“exec format error”等常见错误，强调环境变量设置与构建命令的协同使用。
本文详解如何在 macos 上正确交叉编译 go 程序为目标 linux（amd64）平台，避免“exec format error”等常见错误，强调环境变量设置与构建命令的协同使用。
Go 语言原生支持跨平台编译，无需额外工具链或修改源码——关键在于正确设置构建时的环境变量，并确保它们作用于 go build 命令本身。你遇到的 cannot execute binary file: Exec format error 错误，根本原因是：虽然你成功执行了 ./make.bash（该步骤在较新 Go 版本中已废弃），但后续 go build -v -a 并未指定目标平台，因此默认生成的是 macOS（GOOS=darwin, GOARCH=amd64）可执行文件，而非 Linux 二进制。将其复制到 Ubuntu 后自然无法运行。
✅ 正确做法是：在调用 go build 时，通过环境变量显式声明目标操作系统和架构。无需进入 Go 源码目录、无需重新编译 Go 工具链（自 Go 1.5 起，官方已内置完整交叉编译支持）：
# 在你的项目根目录下执行（假设 main.go 在当前目录） GOOS=linux GOARCH=amd64 go build -v -o test-linux . # 或指定具体包路径（推荐用于模块化项目） GOOS=linux GOARCH=amd64 go build -v -o test-linux ./cmd/myapp
执行后生成的 test-linux 即为标准 Linux ELF 可执行文件，可直接上传至 Ubuntu 20.04/22.04/24.04（64 位）服务器运行：
# 在 Ubuntu 上验证 $ file test-linux test-linux: ELF 64-bit LSB executable, x86-64, version 1 (SYSV), statically linked, Go BuildID=..., stripped $ ./test-linux # 应正常启动
⚠️ 注意事项：
- 环境变量必须紧邻 go build 命令（如 GOOS=linux GOARCH=amd64 go build ...），写成 export GOOS=linux && go build 在某些 shell 中可能因子 shell 行为失效；
- 若项目依赖 cgo（如使用 SQLite、OpenSSL 等），交叉编译将失败——此时需禁用 cgo：
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -a -o test-linux .
（静态链接，无外部动态库依赖，推荐用于部署）
- 支持的 GOOS/GOARCH 组合可通过 go tool dist list 查看，常见组合包括 linux/amd64、linux/arm64、windows/amd64 等；
- 不要使用 go install 进行交叉编译（它会安装到 $GOPATH/bin 且忽略当前环境变量），始终优先使用 go build 并指定 -o 输出路径。
总结：Go 的交叉编译简洁可靠，核心只需两要素——GOOS（目标操作系统）与 GOARCH（目标 CPU 架构）——二者必须作为前缀环境变量作用于 go build 命令。摒弃手动编译 Go 源码等过时操作，即可高效产出即开即用的 Linux 二进制。
