Go 不支持单次编译生成多架构二进制，因 GOARCH 仅接受单值且 ELF/Mach-O/PE 格式不原生支持 fat binary；必须为每个 GOOS/GOARCH 组合单独构建并显式指定 CGO_ENABLED=0 等参数。
Go 无法生成单个二进制同时支持 ARM 和 x86 —— 它不支持 fat binary，必须为每个 GOOS/GOARCH 组合单独构建。
为什么不能用 GOARCH=arm64,amd64 一次编译
Go 编译器的 GOARCH 环境变量只接受单值，逗号分隔会被忽略或报错；go build 输出的是标准 ELF/Mach-O/PE 格式，这些格式本身不支持多架构嵌套。Apple 的 universal binary 是 Mach-O 的私有扩展，Go 工具链未实现，也不存在跨平台等效机制。
常见错误现象：
- 执行
GOARCH=arm64,amd64 go build后，实际只生成 arm64 二进制（后半段被丢弃） - 用
lipo尝试合并两个 Go 二进制：失败，提示“not a universal binary”或“file is not a Mach-O file” - Linux/Windows 下根本无
lipo替代工具，无法模拟该行为
正确做法：显式调用多次 go build
在项目根目录写一个构建脚本，为每个目标平台分别执行 go build，并控制输出路径和文件名。关键参数必须显式声明：
立即学习“go语言免费学习笔记（深入）”；
-
CGO_ENABLED=0必须加，否则net、os/user等包可能隐式启用 cgo，导致动态链接失败 - Windows 目标必须带
.exe后缀，否则双击无法运行（即使GOOS=linux也别依赖自动去后缀） - ARM32 设备（如树莓派 Zero）需额外设
GOARM=7，仅GOARCH=arm不够 - 输出统一到
./dist/目录，避免污染源码树
示例 build-all.sh 片段：
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
#!/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=windows GOARCH=amd64 go build -o ./dist/app-win64.exe . CGO_ENABLED=0 GOOS=darwin GOARCH=arm64 go build -o ./dist/app-macos-arm64 .
CI/CD 中构建多平台镜像别用 QEMU 全流程模拟
在 AMD64 CI 节点上构建 ARM64 镜像时，直接用 docker buildx build --platform linux/arm64 默认会拉起 ARM64 容器 + QEMU 模拟所有 RUN 指令，导致 Go 编译等 CPU 密集型步骤慢 5–10 倍，还容易因原子指令翻译出 Segmentation Fault。
推荐方案是「构建与打包分离」：
- 先在宿主原生架构（AMD64）下，用
GOOS=linux GOARCH=arm64直接交叉编译出 ARM64 二进制 - Dockerfile 使用多阶段构建，在 builder 阶段仍用
golang:alpine，但最终COPY进来的已是预编译好的 ARM64 二进制 - 这样
buildx只需做轻量装配，无需模拟任何编译过程
关键点：docker buildx build --platform linux/amd64,linux/arm64 能同时产出两个镜像，但前提是 Dockerfile 不在 RUN 中调用 go build。
验证生成结果是否真匹配目标平台
不要靠文件名或经验判断，必须用系统命令确认：
- Linux/macOS 上跑
file ./app-linux-arm64，输出应含ELF 64-bit LSB executable, ARM aarch64 - 若显示
x86-64或Intel 80386，说明GOARCH设错了 - 在目标机器上运行报
exec format error，99% 是架构不匹配，不是权限或缺失库 - Windows 上可用
sigcheck -a ./app-win64.exe查 PE 头的 Machine 字段（AMD64vsARM64）
最容易被忽略的是 GOOS 漏设：只设 GOARCH=arm64，没设 GOOS=linux，Go 默认按 darwin 构建，拿到 Linux 上必然失败。
