Go原生支持多平台编译，但Makefile中GOOS和GOARCH必须每条命令前显式设置，export无效；CGO_ENABLED=0需同层共用，输出名须含平台标识并显式加.exe后缀。
GOOS 和 GOARCH 必须每条命令前显式设置
Makefile 不继承 shell 环境变量，export GOOS=linux 对后续 go build 完全无效。常见错误写法：
build-linux: export GOOS=linux go build -o bin/app ./cmd/myapp
这实际是两条独立命令，第二行仍在当前平台（比如 macOS）构建，输出仍是 darwin 二进制。
正确做法只有一种：环境变量必须作为命令前缀，与 go build 在同一行：
GOOS=linux GOARCH=amd64 go build -o bin/app-linux-amd64 ./cmd/myappGOOS=darwin GOARCH=arm64 go build -o bin/app-darwin-arm64 ./cmd/myappCGO_ENABLED=0 GOOS=windows GOARCH=amd64 go build -o bin/app-windows-amd64.exe ./cmd/myapp
漏掉任一变量，就不是真正交叉编译——哪怕输出名写了 -linux，文件本质还是当前系统格式。
立即学习“go语言免费学习笔记（深入）”；
Windows 二进制必须显式加 .exe 后缀
Go 在非 Windows 系统上交叉编译 Windows 时，go build 不会自动补 .exe；不加后缀会导致生成的文件无执行权限、CI 流水线识别失败、部署时被当成普通文件。
不要依赖系统行为，统一显式写死：
- 错：
-o bin/app-windows→ 输出app-windows（Linux/macOS 上无扩展名） - 对：
-o bin/app-windows-amd64.exe→ 输出带.exe的可执行文件
注意：后缀是文件名一部分，不是平台判断逻辑。即便在 macOS 上跑 GOOS=windows，也必须手写 .exe。
输出路径必须带平台标识，且提前创建目录
所有平台二进制塞进 bin/app 会互相覆盖，且无法区分来源。真实发布中因此发错包的案例极多。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
推荐命名格式：$(BIN_NAME)-$(GOOS)-$(GOARCH)，Windows 额外加 .exe：
app-linux-amd64app-darwin-arm64app-windows-amd64.exe
同时，每个 build-* target 前必须加 mkdir -p bin/：
build-linux-amd64: mkdir -p bin/ GOOS=linux GOARCH=amd64 CGO_ENABLED=0 go build -o bin/app-linux-amd64 ./cmd/myapp
否则 go build 遇到 bin/ 不存在直接报错退出。
CGO_ENABLED=0 是跨平台构建的默认安全选项
开启 CGO_ENABLED=1（默认）会导致：
- Linux 构建链接 libc，二进制在 Alpine 容器里运行时报
not found - macOS 编译 Windows 直接失败（cgo 不支持 win-cross）
- net/http 默认用纯 Go DNS 解析器（
netgo），不读/etc/resolv.conf
所以除非明确需要 cgo 特性（如 SQLite、OpenSSL），否则一律前置 CGO_ENABLED=0：
CGO_ENABLED=0 GOOS=linux GOARCH=arm64 go build -o bin/app-linux-arm64 ./cmd/myapp
若需系统 DNS，启动时加 GODEBUG=netdns=system，而非打开 cgo。
最易被忽略的是：GOOS/GOARCH 和 CGO_ENABLED 必须同层共存于一条命令中；分开写、用 export、或靠 Makefile 变量传递，都会失效。交叉编译不是“配置一次，全局生效”，而是“每条构建命令，各自声明”。
