Go不支持单二进制多架构（如macOS universal binary），因其输出的ELF/PE/Mach-O格式不原生支持fat binary，且GOARCH仅接受单值；必须为每个GOOS/GOARCH组合单独构建并分发。
Go 项目无法生成“单个二进制支持 ARM + AMD”——它不支持 fat binary（多架构合并），必须为每个 GOOS/GOARCH 组合单独构建，再按需分发。
为什么不能像 macOS 那样打包一个通用二进制？
Go 编译器输出的是标准 ELF（Linux）、Mach-O（macOS）或 PE（Windows）格式，这些格式本身不支持多架构嵌套。Apple 的 universal binary 是 Mach-O 的扩展特性，Go 官方工具链未实现该机制。试图用 lipo 合并两个 Go 二进制会失败：它们不是兼容的 Mach-O slice，且 Linux/Windows 根本没有对应工具。
常见误解是“只要写对 GOARCH=arm64,amd64 就能一次出多个”，但 GOARCH 不接受逗号分隔列表；它只认单值。
正确做法：用构建脚本批量生成各平台二进制
推荐在项目根目录下写一个 shell 脚本（Linux/macOS）或批处理（Windows），显式调用多次 go build：
立即学习“go语言免费学习笔记（深入）”；
例如 build-all.sh：
#!/bin/bash CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o ./dist/app-linux-amd64 . CGO_ENABLED=0 GOOS=linux GOARCH=arm64 go build -o ./dist/app-linux-arm64 . CGO_ENABLED=0 GOOS=darwin GOARCH=amd64 go build -o ./dist/app-macos-amd64 . CGO_ENABLED=0 GOOS=darwin GOARCH=arm64 go build -o ./dist/app-macos-arm64 . CGO_ENABLED=0 GOOS=windows GOARCH=amd64 go build -o ./dist/app-win64.exe .
-
CGO_ENABLED=0必须显式加，否则遇到net、os/user等包可能隐式启用 cgo，导致动态链接失败 - Linux ARM 设备若为 32 位（如树莓派 Zero），需额外加
GOARM=7：GOOS=linux GOARCH=arm GOARM=7 - Windows 输出名必须带
.exe后缀，否则双击不识别 - 输出路径建议统一用
./dist/，避免污染源码目录
交叉编译时 exec format error 的真实原因
这个错误几乎总是因为目标架构不匹配，而不是权限或缺失依赖：
- 在
aarch64（ARM64）机器上运行了GOARCH=arm（32 位）编译的二进制 → 报错 - 在树莓派 4（ARM64）上误用了
GOARCH=arm+GOARM=7→ 仍是 32 位，内核拒绝加载 -
GOOS漏设：只设GOARCH=arm64，没设GOOS=linux→ 默认按 macOS 构建，拿到 Linux 上当然报 exec format error - 验证方式：在目标机上运行
file ./app，确认输出含ARM aarch64或x86-64，而非x86或Intel 80386
CI/CD 中自动化构建多架构的关键配置点
GitHub Actions 或 GitLab CI 里，别依赖宿主机环境变量覆盖 —— 显式写死在 builds 配置中更可靠：
例如 .goreleaser.yaml 片段：
builds:
- id: linux-amd64
main: ./cmd/myapp
binary: myapp
goos: [linux]
goarch: [amd64]
env: ["CGO_ENABLED=0"]
- id: linux-arm64
main: ./cmd/myapp
binary: myapp
goos: [linux]
goarch: [arm64]
env: ["CGO_ENABLED=0"]
-
goos和goarch必须是数组，哪怕只填一个值，也不能写成字符串 -
env写在每个build下，比全局env更优先，防止 CI 环境中CGO_ENABLED=1覆盖 - Windows 构建项必须包含
binary: myapp.exe，否则 Release 页面下载后无法执行
真正容易被忽略的是：构建完不验证就发布。哪怕只是 file dist/app-linux-arm64 看一眼 ABI，也能避开 80% 的现场翻车。
