Go跨平台交叉编译成功的关键是同时显式设置GOOS和GOARCH并关闭CGO_ENABLED=0；漏设任一变量或启用CGO，易导致目标机器报cannot execute binary file或no such file or directory。
Go 本身不依赖额外工具链就能完成跨平台编译，关键不是“装什么”，而是“怎么设环境变量”——GOOS 和 GOARCH 必须同时显式指定，缺一不可；CGO_ENABLED=0 是绝大多数项目稳定输出的默认前提。
GOOS 和 GOARCH 必须成对设置，不能只设一个
Go 默认只构建当前运行平台的二进制（比如在 macOS 上执行 go build 得到的是 darwin/amd64）。想生成其他平台文件，GOOS 和 GOARCH 必须一起出现在命令行前，且顺序无关：
GOOS=linux GOARCH=arm64 go build -o app-linux-arm64 main.go-
GOARCH=amd64 GOOS=windows go build -o app.exe main.go（Windows 必须加.exe后缀） - 单独设
GOOS=linux不生效，仍会生成当前平台二进制 - 可用
go tool dist list查看所有支持组合，例如linux/arm64、windows/386、darwin/arm64
CGO_ENABLED=0 是纯 Go 项目的默认安全选项
启用 CGO（即 CGO_ENABLED=1）会让编译器调用宿主机 C 工具链，而它无法跨平台生成目标系统代码，99% 的交叉编译失败都源于此。除非你明确依赖 C 库（如 sqlite3、openssl），否则直接关掉：
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o server main.go- 关闭后生成的是静态链接二进制，不依赖目标机上的
libc或gcc - 标准库中
net、os/exec等行为不受影响，DNS 解析等默认走纯 Go 实现 - 若项目里有
// #cgo指令或import "C"，关 CGO 会直接报错，此时必须用 Docker 或目标机构建
ARM 架构需注意 GOARM（仅限 GOARCH=arm）
GOARCH=arm64 是 Apple Silicon、树莓派 4/5 等主流 64 位 ARM 设备的标准配置，无需额外参数；但若目标是老款 32 位 ARM（如树莓派 Zero），则必须配合 GOARM：
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
GOOS=linux GOARCH=arm GOARM=7 go build -o app-rpi-zero main.go-
GOARM只对GOARCH=arm有效，值为 5/6/7，对应不同浮点协处理器版本 -
GOARCH=arm64完全忽略GOARM，设了也无效 - 混淆
arm和arm64是常见错误：树莓派 4B 默认是arm64，不是arm
验证编译结果是否真的可运行，别信“没报错就成功”
交叉编译过程不报错 ≠ 生成的文件能在目标机上跑。真正要检查的是文件格式和运行能力：
- 用
file app-linux-arm64看输出：应含ELF 64-bit LSB executable, ARM aarch64 - 用
file app.exe看输出：应含PE32+ executable (console) x86-64 - 不要在宿主机上直接执行（比如 macOS 上
./app.exe），否则报exec format error是正常现象 - 最简验证方式：上传到目标机器
chmod +x后执行，或用docker run --rm -v $(pwd):/app -w /app arm64v8/alpine /app/app-linux-arm64
真正容易被忽略的是：环境变量只在当前 shell 命令生命周期内生效，写脚本时别漏掉 export 或重复设置；另外，go build 读取的是构建瞬间的变量值，代码里 runtime.GOOS 永远返回宿主机系统，不是目标平台。
