GOOS和GOARCH环境变量决定编译目标平台，设置后执行go build即可跨平台编译；需注意大小写规范及本地Go版本对目标平台的支持情况。
GOOS 和 GOARCH 环境变量决定编译目标平台
Go 原生支持跨平台编译，不需要安装多个 SDK 或虚拟机。关键在于正确设置 GOOS（目标操作系统）和 GOARCH（目标 CPU 架构）环境变量，再执行 go build 即可生成对应平台的二进制文件。
常见组合示例：
GOOS=windows GOARCH=amd64 go build -o app.exe main.goGOOS=linux GOARCH=arm64 go build -o app-linux-arm64 main.goGOOS=darwin GOARCH=arm64 go build -o app-macos main.go
注意：GOOS 值必须小写（windows 不是 Windows），GOARCH 区分大小写但通常全小写（arm64、amd64）。macOS 上若要生成 Intel 版本，需设为 GOARCH=amd64，即使你用的是 M1/M2 芯片。
交叉编译前先确认本地 Go 是否支持目标平台
不是所有 Go 版本都默认支持全部 GOOS/GOARCH 组合。例如旧版 Go（darwin/arm64 支持不完整；某些嵌入式架构（如 GOARCH=riscv64）需 Go 1.21+ 才稳定支持。
立即学习“go语言免费学习笔记（深入）”；
运行 go tool dist list 可查看当前 Go 安装支持的所有平台组合。输出中包含 linux/amd64、windows/386 等条目，没列出的组合大概率会报错 build constraints exclude all Go files 或 cannot find package "syscall"。
如果你需要支持 android 或 ios，还需额外安装 NDK / Xcode 工具链，并启用 CGO_ENABLED=1 —— 这类场景已超出纯 Go 编译范畴，实际构建会更复杂。
CGO_ENABLED=0 是跨平台静态编译的关键开关
默认开启 CGO 时，Go 会链接系统 C 库（如 glibc），导致生成的二进制无法在其他 Linux 发行版或 musl 系统（如 Alpine）上运行。解决方法是禁用 CGO：
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -a -ldflags '-s -w' -o app-linux main.go
说明：
-
CGO_ENABLED=0：强制纯 Go 实现（禁用 net、os/user 等依赖 libc 的包） -
-a：重新编译所有依赖（含标准库），确保无残留 cgo 引用 -
-ldflags '-s -w'：剥离调试符号和 DWARF 信息，减小体积
副作用：部分功能受限，比如 user.Lookup 在 CGO_ENABLED=0 下会返回错误；DNS 解析退回到纯 Go 实现（可能慢于系统 resolver）。
Windows 上生成 macOS 二进制？别试了
Go 官方明确不支持从 Windows 构建 darwin/* 目标（即 macOS 二进制）。即使设置了 GOOS=darwin，也会报错 cannot build darwin binary on windows。同理，Linux 主机也不能直接构建 ios 或 darwin 产物。
真正可行的方案只有两种：
- 在 macOS 机器上构建所有
darwin/*和ios/*目标 - 用 GitHub Actions / GitLab CI 等服务，在 macOS runner 上自动触发构建（例如使用
runs-on: macos-latest）
试图用 Docker 模拟 macOS 环境是徒劳的——内核和系统调用层完全不兼容，不是换个 rootfs 就能绕过的。
