go原生支持多平台编译，但makefile中必须每条构建命令前显式设置goos和goarch（如goos=linux goarch=amd64），否则默认仅构建当前系统平台；需禁用cgo_enabled=0、输出路径带平台标识、windows加.exe后缀、arm按需设goarm等。
直接说结论：Go 原生支持多平台编译，但 Makefile 里不显式传 GOOS 和 GOARCH，就永远只构建当前系统平台——哪怕你写了 go build -o bin/app-linux，在 macOS 上跑出来的仍是 darwin 二进制。
GOOS/GOARCH 必须每条命令前显式设置
Makefile 不会继承 shell 环境变量，export GOOS=linux 对后续 go build 无效。常见错误是写成：
build-linux: export GOOS=linux go build -o bin/app-linux ./cmd/myapp
这实际等价于两行独立命令，第二行根本没生效。正确写法只有一种：
- 每条构建命令前加环境变量前缀：
GOOS=linux GOARCH=amd64 go build -o bin/app-linux-amd64 ./cmd/myapp - Windows 平台必须显式加
.exe后缀：-o bin/app-windows.exe，否则 Linux/macOS 上生成的文件无扩展名，CI 里可能被当成非可执行文件 - ARM 架构需额外传
GOARM=7（ARMv7）或GOAMD64=v3（AVX 指令集），否则 ARM64 设备运行时可能 panic
输出路径必须带平台标识，避免覆盖和混淆
所有平台二进制塞进同一目录（比如都叫 bin/app）会导致反复 make 时互相覆盖，且无法区分哪次构建对应哪个平台。真实部署中常因此发错包。
- 输出名建议用
$(BIN_NAME)-$(GOOS)-$(GOARCH)格式，如app-linux-amd64、app-darwin-arm64 - Windows 要单独处理后缀：
app-windows-amd64.exe，不能靠系统自动补 - 提前创建输出目录：
mkdir -p bin/必须作为每个build-*target 的前置动作，否则go build会因目录不存在失败
交叉编译前务必禁用 CGO
默认开启 CGO_ENABLED=1 时，Go 会动态链接 libc，导致 Linux 二进制在 Alpine 容器里报 not found；macOS 编译 Windows 二进制则直接失败。
- 统一加
CGO_ENABLED=0前缀：CGO_ENABLED=0 GOOS=windows GOARCH=amd64 go build ... - 注意副作用：禁用 CGO 后，
net/http默认用纯 Go DNS 解析器（netgo），不读取/etc/resolv.conf，若依赖系统 DNS 配置需显式设GODEBUG=netdns=system - CI 流水线里不要依赖本地环境的
CGO_ENABLED值，必须显式写出
用变量+foreach 动态生成 target，别硬写六七条
手动列 build-linux-amd64、build-linux-arm64、build-darwin-amd64……既难维护又容易漏平台，尤其新增 freebsd/amd64 时得改三处（target 名、命令、help 文本）。
- 定义平台列表：
OSARCHS = linux/amd64 linux/arm64 darwin/amd64 windows/amd64 - 用
$(foreach osarch,$(OSARCHS),$(eval $(call build-target,$(osarch))))自动生成每个 target - 每个 target 名为
build-linux_amd64（下划线分隔），支持通配调用：make build-linux%或make build-% -
-ldflags注入版本信息时，确保$(VERSION)来自git describe且带--dirty，否则干净工作区和 dirty 工作区产出的二进制哈希值相同
真正麻烦的不是写对一条命令，而是让不同人、不同机器、不同 CI 环境跑出来的二进制完全一致——GOOS/GOARCH 显式、CGO_ENABLED=0 显式、输出路径隔离、go mod tidy 独立执行，缺一不可。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
