Go原生支持多平台交叉编译，需显式设置GOOS（如windows、linux、darwin）和GOARCH（如amd64、arm64），并禁用CGO（CGO_ENABLED=0），否则默认生成宿主机二进制；验证用file命令，注意后缀、路径分隔符及embed路径规范。
Go 原生支持多平台交叉构建，不需要额外装工具链，只要正确设置 GOOS 和 GOARCH，再关掉 CGO_ENABLED，基本就能在本地（比如 macOS 或 Linux）直接打出 Windows、Linux、macOS 各种组合的二进制。
必须显式设置 GOOS 和 GOARCH
Go 不会自动猜你要编译哪个平台。漏设、拼错、大小写不对（比如写成 goos 或 GO_OS），都会导致默默生成当前宿主机平台的二进制——你以为打出了 .exe，其实还是个 Linux ELF 文件。
-
GOOS可选值：linux、windows、darwin（不是macos） -
GOARCH常见值：amd64、arm64、386（Windows 32 位）、arm（ARM32，较少用） - 组合示例：
GOOS=windows GOARCH=arm64 go build -o app.exe main.go - 验证是否成功：用
file app.exe看输出，应含PE32+；Linux 二进制应含ELF 64-bit LSB executable
绝大多数情况要设 CGO_ENABLED=0
开启 CGO（即 CGO_ENABLED=1）会让 Go 调用本地 C 编译器（如 gcc 或 clang），而这些编译器默认只生成本机格式的目标文件，直接导致交叉编译失败。除非你明确依赖 cgo 绑定的库（如 sqlite3、openssl），否则一律禁用。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 纯 Go 项目（HTTP 服务、CLI 工具、gRPC server）基本都不需要 CGO
- 标准库中
net、os/exec、crypto/*等模块在CGO_ENABLED=0下行为一致 - 错误现象：macOS 上启用 CGO 编译 Windows 二进制时，报
exec format error或找不到cc - 正确写法：
CGO_ENABLED=0 GOOS=darwin GOARCH=arm64 go build -o app-darwin-arm64 main.go
注意后缀、符号和路径兼容性
交叉编译完成不等于能在目标平台跑起来，几个细节容易被跳过：
立即学习“go语言免费学习笔记（深入）”；
- Windows 二进制必须带
.exe后缀，否则双击或命令行执行都失败 - Linux 二进制若含调试信息，体积可能翻倍；加
-ldflags="-s -w"可裁剪：go build -ldflags="-s -w" -o app-linux main.go - 代码里别硬写
/或\路径分隔符，统一用filepath.Join() - 如果用了
//go:embed，路径必须是 Unix 风格（正斜杠），且不能以../开头
真正卡住人的往往不是语法，而是构建完没验证、或者误把 Windows 二进制拖到 macOS 上双击运行——它当然跑不了，但这个错误跟你写的 Go 代码毫无关系。
