Go原生支持交叉编译，关键在于必须同时显式设置GOOS和GOARCH，且CGO_ENABLED=0虽可生成静态二进制，但在DNS解析、os/user、SQLite等场景易致运行时失败；单独设置GOOS或GOARCH无效，go tool dist list可查支持组合。
Go 原生支持交叉编译，不需要额外安装工具链，但必须正确设置 GOOS 和 GOARCH，且是否启用 cgo 会直接决定能否成功生成目标平台可运行的二进制文件——尤其在涉及 DNS、用户信息、SQLite 等场景时，CGO_ENABLED=0 表面能编译通过，实则可能埋下运行时失败的坑。
GOOS 和 GOARCH 必须配对使用，不能只设一个
单独设置 GOOS=linux 而不指定 GOARCH，Go 仍会按当前宿主机架构（如 darwin/amd64）编译，结果不是真正的交叉编译。常见组合需严格匹配：
-
GOOS=linux GOARCH=amd64：通用 Linux x86_64 -
GOOS=linux GOARCH=arm64：ARM64 服务器或树莓派 4/5 -
GOOS=linux GOARCH=arm GOARM=7：ARMv7 设备（如部分车机、老款嵌入式板） -
GOOS=windows GOARCH=386：32 位 Windows（注意：需 Go 源码构建环境才可靠，预编译版可能缺失386标准库） -
GOOS=darwin GOARCH=arm64：Apple Silicon（M1/M2/M3）Mac
运行 go tool dist list 可查看本地 Go 版本完整支持列表；若输出中无 linux/arm64，说明 Go 版本过低（
CGO_ENABLED=0 不是万能解药，反而常掩盖真实问题
很多教程直接推荐 CGO_ENABLED=0 来“保证静态链接”，但它会让以下功能退化或失效：
立即学习“go语言免费学习笔记（深入）”；
-
net包 DNS 解析 fallback 到纯 Go 实现，无法使用系统/etc/resolv.conf或 systemd-resolved，内网 DNS 经常超时 -
user.Lookup、user.Current返回空或 panic，因依赖 libc 的getpwuid - 所有 cgo 绑定库（如
mattn/go-sqlite3、golang.org/x/sys/unix中部分函数）直接不可用
真正需要 cgo 时，必须启用并配齐目标平台 C 工具链：
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- Linux → ARM64：
CC=aarch64-linux-gnu-gcc，Debian/Ubuntu 下装gcc-aarch64-linux-gnu - macOS → Linux AMD64：
CC=x86_64-linux-gnu-gcc，用 Homebrew 安装crossbuild-essential-amd64 - Windows → Linux：WSL2 内操作更稳，原生 Windows 上 MinGW 编译器无法生成 Linux 二进制
验证是否生效：加 -x 参数运行 go build -x，搜索日志中 gcc 调用行，确认路径指向你指定的交叉编译器。
Docker 是最省心的交叉编译沙箱，尤其适合带 cgo 的项目
本地装一堆交叉 GCC 工具链容易冲突，Docker 提供隔离、可复用、版本可控的环境：
- 用官方镜像起步：
docker run --rm -v $(pwd):/app -w /app golang:1.22-alpine sh -c "apk add --no-cache gcc musl-dev && CGO_ENABLED=1 GOOS=linux GOARCH=arm64 go build -o app-arm64 ." - 若需完整 libc（如 glibc 项目），换用
debian:slim基础镜像，并apt install gcc-arm64-linux-gnu - 对 Android/iOS 等特殊平台，优先考虑
karalabe/xgo这类预置多平台工具链的镜像，避免手动配置CC、CGO_CFLAGS等
注意：Docker 内执行 go build 时，GOOS/GOARCH 仍需显式传入，容器 OS（如 Alpine）不影响目标平台，只影响构建环境可用性。
LoongArch64、RISC-V 等新架构需特别注意 Go 版本和工具链
龙芯 LoongArch64（GOARCH=loong64）从 Go 1.20 起稳定支持，但低于此版本会静默失败；RISC-V（GOARCH=riscv64）要求 Go ≥ 1.16，且必须配 CC=riscv64-linux-gnu-gcc。
- 检查支持：
go version必须 ≥ 1.20（LoongArch）或 ≥ 1.16（RISC-V） - 交叉 GCC 必须存在：
riscv64-linux-gnu-gcc --version或loongarch64-linux-gnu-gcc --version要能执行 - 禁用 cgo 会导致
os/user、net等包行为异常，这类架构上更不能盲目设CGO_ENABLED=0
最容易被忽略的是：即使 Go 支持某架构，标准库中某些包（如 crypto/x509 的系统根证书加载）仍依赖目标平台的 C 库路径和 sysroot 设置，此时仅靠 GOOS/GOARCH 远远不够。
