Go原生支持交叉编译，只需设置GOOS和GOARCH环境变量即可生成目标平台二进制文件；CGO_ENABLED=0时最简单可靠，启用CGO则需匹配的目标平台C工具链。
Go 交叉编译不需要额外安装工具链
Go 原生支持跨平台编译，只要设置好 GOOS 和 GOARCH 环境变量，就能直接生成目标平台的二进制文件。不需要像 C/C++ 那样下载、配置独立的交叉编译器（如 aarch64-linux-gnu-gcc）。
常见组合示例：
-
GOOS=linux GOARCH=amd64 go build→ Linux x86_64 -
GOOS=windows GOARCH=arm64 go build→ Windows ARM64（.exe） -
GOOS=darwin GOARCH=arm64 go build→ macOS Apple Silicon
注意：CGO_ENABLED=0 在多数纯 Go 项目中建议显式关闭，避免因本地 C 工具链缺失或版本不匹配导致失败。
macOS 上编译 Windows 或 Linux 二进制常报 “exec format error”
这不是 Go 的问题，而是你误把生成的二进制文件在宿主机（macOS）上直接运行了。比如执行 GOOS=windows go build 后得到 main.exe，它只能在 Windows 上跑，在 macOS 上双击或 ./main.exe 必然失败，报错类似 exec format error 或 cannot execute binary file。
立即学习“go语言免费学习笔记（深入）”；
验证是否成功：用 file main.exe 查看输出，应含 PE32+ executable (console) x86-64；Linux 下则应为 ELF 64-bit LSB executable。
真正需要检查的是构建过程本身是否报错——只要没报错，就说明交叉编译成功了。
在 Go 中使用 google/wire 实现编译时依赖注入——wire.NewSet、wire.Build、wire.Bind（接口→实现）、wire.Struct、wire.Value、wire.Interface
CGO_ENABLED=1 时交叉编译会失败
一旦启用 CGO（即 CGO_ENABLED=1），Go 就会调用宿主机的 C 编译器（如 clang 或 gcc）链接 C 代码，而这些编译器默认只生成本机格式的目标文件，无法跨平台。
解决方法只有两个：
- 设
CGO_ENABLED=0（推荐，适用于无 C 依赖或已用纯 Go 替代的项目，如net、os/exec等标准库行为基本不受影响） - 若必须用 CGO（例如调用
libsqlite3、openssl），就得为每个目标平台准备对应 C 工具链，并设置CC_for_target变量，例如：CC_linux_arm64=aarch64-linux-gnu-gcc GOOS=linux GOARCH=arm64 CGO_ENABLED=1 go build
绝大多数服务端 CLI 工具、HTTP 服务都不需要 CGO，强行开启反而增加构建复杂度和出错概率。
Windows 上编译 Linux 二进制要注意换行符和路径分隔符
Go 本身不关心换行符，但如果你的项目里有内嵌脚本（如 //go:embed assets/deploy.sh）、或生成配置文件时硬编码了 \n / \r\n，那不同平台的文本处理逻辑可能引发兼容问题。
更隐蔽的问题是路径拼接：filepath.Join("etc", "config.yaml") 在 Windows 上返回 etc\config.yaml，但在 Linux 目标环境里，这个反斜杠会被当作普通字符而非路径分隔符，导致打开失败。所以务必统一用 filepath.Join，别手写 "etc/config.yaml" 或字符串拼接。
另外，Windows 默认终端对 UTF-8 支持较弱，如果程序输出中文日志且未显式设置控制台编码，可能在 Windows 终端显示乱码——这和交叉编译无关，但容易被误认为构建问题。
