交叉编译必须同时指定goos和goarch，缺一不可；禁用cgo_enabled=0是生成零依赖二进制的关键；生成的二进制仅能在目标平台运行，无法在宿主机直接执行。
GOOS和GOARCH必须同时指定才能生效
交叉编译失败最常见的原因是只设了 GOOS 没设 GOARCH，或者反过来。Go 不会自动推导缺失项，缺一不可。
比如想编译 macOS 上运行的二进制，不能只写 GOOS=darwin go build——它仍会用当前机器的 GOARCH（如 amd64），但 macOS 默认已不支持 32 位或旧架构；若目标是 Apple Silicon，则必须显式加 GOARCH=arm64。
GOOS=linux GOARCH=amd64 go build -o app-linux-amd64 main.go-
GOOS=windows GOARCH=386 go build -o app-win32.exe main.go（注意 Windows 下输出文件名需带.exe后缀才可执行） - macOS + Intel：
GOOS=darwin GOARCH=amd64 go build …；macOS + M1/M2：GOOS=darwin GOARCH=arm64 go build …
CGO_ENABLED=0 是跨平台干净编译的关键开关
默认开启 CGO 时，go build 会尝试调用本地 C 工具链（如 gcc）、链接系统库（如 libc）。这在交叉编译时几乎必然失败——你的 Linux 机器没有 Windows 的 kernel32.lib，Mac 也没有 musl-gcc。
绝大多数纯 Go 程序不需要 CGO；一旦禁用，Go 会使用自带的 net/DNS 实现、静态链接所有依赖，产出真正零依赖的二进制。
- 务必加
CGO_ENABLED=0：例如CGO_ENABLED=0 GOOS=linux GOARCH=arm64 go build -o app-arm64 main.go - 如果用了
net/http或database/sql，禁用 CGO 后 DNS 解析走纯 Go 实现（稍慢但可靠），SQLite 驱动需换为mattn/go-sqlite3的纯 Go 分支（如github.com/ncruces/go-sqlite3） - 只有当你明确需要调用 C 库（如 OpenSSL、CUDA）时才保留
CGO_ENABLED=1，此时必须配好对应平台的交叉 C 工具链，复杂度陡增
交叉编译生成的二进制无法在宿主机直接运行
这是新手最常卡住的一点：你在 macOS 上执行 GOOS=linux go build，得到一个 app 文件，双击或 ./app 报错 “Bad CPU type in executable” 或 “cannot execute binary file”，不是编译错了，是它压根就不是给你本机准备的。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
生成的文件只能在目标平台运行。验证方式只有两种：扔到对应系统的机器上跑，或用容器模拟（如 docker run --rm -v $(pwd):/work -w /work golang:alpine sh -c "GOOS=linux GOARCH=arm64 go build -o app-arm64 ."）。
- Linux
amd64二进制在 macOS 上file app显示 “ELF 64-bit LSB executable, x86-64”，说明它是 Linux 格式，macOS 内核拒绝加载 - Windows 编译出的
.exe在 Linux 用wine运行属于兼容层方案，不属于 Go 交叉编译范畴，别混在一起调试 - 不要试图用
qemu-user-static在本地“运行测试”——它解决的是容器内指令翻译，不是编译流程本身是否正确
vendor 目录和 go.mod 版本对交叉编译无特殊影响
有人担心 go mod vendor 或 go.sum 锁定版本会影响跨平台行为，其实不会。Go 的模块机制与构建目标平台无关，只要源码能通过 go build 类型检查，vendor 或非 vendor 模式产出的二进制内容一致。
真正要注意的是：某些包在不同 GOOS 下有不同实现（如 os/user 在 Windows 和 Unix 下走不同代码路径），这些由构建时条件编译（// +build 或 //go:build）控制，不是模块系统的事。
- 无需为交叉编译单独
go mod vendor，go build本身就能离线工作（前提是依赖已下载过） - 如果项目用了
//go:build !windows这类约束，确保目标平台满足条件；否则编译会跳过某些文件，导致符号未定义 -
go list -f '{{.Target}}' .可查看当前环境实际生效的构建标签，比猜更可靠
最容易被忽略的其实是 CGO_ENABLED 的默认值——它在 macOS/Linux 是 1，在 Windows 是 0。同一份 CI 脚本在不同机器上行为不一致，往往就栽在这儿。每次写交叉编译命令，先敲 CGO_ENABLED=0 几乎成了肌肉记忆。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
