Go原生支持多平台编译，但必须显式设置GOOS和GOARCH，且绝大多数情况需CGO_ENABLED=0；Windows输出须加.exe后缀，ARM需配GOARM，路径用filepath.Join，构建前应清理缓存。
Go 原生支持多平台构建，不需要额外 SDK 或虚拟机——关键在于正确设置 GOOS 和 GOARCH，并提前规避 cgo 依赖、路径硬编码、构建缓存污染等实际踩坑点。
GOOS/GOARCH 交叉编译必须知道的组合与限制
Go 工具链内置所有目标平台支持，用 go tool dist list 可查全量列表。但日常高频组合就那么几个，且有隐含约束：
-
GOOS=windows时，输出文件名必须带.exe后缀（否则 Windows 不认），其他平台无需后缀 -
GOOS=darwin搭配GOARCH=arm64仅支持 macOS 11.0+；若需兼容旧版 macOS，得用GOARCH=amd64+ Rosetta 2 -
GOOS=linux下GOARCH=arm必须配合GOARM=7（或GOARM=6），否则编译失败 - 所有组合默认生成静态链接二进制，但一旦启用
cgo（如用了net包的 DNS 解析、os/user），就会动态链接 libc，跨平台部署时可能报cannot execute binary file: Exec format error或no such file or directory
CGO_ENABLED=0 不是万能解药，但多数 CLI 和服务端场景该关
关闭 cgo 能彻底避免目标平台 C 运行时依赖，让二进制真正“开箱即用”。但它会影响部分标准库行为：
-
net包会退化为纯 Go DNS 解析器（绕过系统resolv.conf），可能无法解析内网域名 -
os/user、os/exec（某些 shell 特性）功能受限 - SQLite、OpenSSL 等依赖 C 的第三方库直接不可用
实操建议：
立即学习“go语言免费学习笔记（深入）”；
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- CLI 工具、微服务、Daemon 类程序：默认加
CGO_ENABLED=0 - 需要调用系统用户数据库或依赖特定 DNS 配置的服务：保留
cgo，改用 Docker 构建（例如golang:1.22-alpine镜像里预装 musl-gcc） - CI/CD 中统一加
CGO_ENABLED=0，本地调试再临时开启
Makefile 或 mage 是比 shell 脚本更靠谱的跨平台构建入口
直接写 build.sh 在 Windows 上跑不起来，写 build.ps1 又让 Linux/macOS 用户抓狂。用 Go 写构建逻辑最稳：
-
mage（推荐）：纯 Go 编写的任务运行器，mage build:linux这种命令三端一致，还能复用runtime.GOOS做条件判断 - 自研
cmd/build/main.go：用os/exec.Command封装go build，自动拼接GOOS/GOARCH和输出路径，比 Bash 更易测试和 debug - 绝对避免在 Git 提交
.sh+.bat双版本脚本——合并冲突、权限丢失、换行符问题频发
示例 magefile.go 片段：
func BuildLinux() error {
return build("linux", "amd64", "myapp-linux-amd64")
}
func build(goos, goarch, output string) error {
cmd := exec.Command("go", "build", "-o", output, "./cmd/myapp")
cmd.Env = append(os.Environ(),
"GOOS="+goos,
"GOARCH="+goarch,
"CGO_ENABLED=0",
)
return cmd.Run()
}
go.mod + go.sum 是跨平台一致性的唯一可信锚点
不同平台拉代码、跑 go build 结果不一致？八成是依赖没锁死或 GOPATH 干扰。必须做到：
- 项目初始化只用
go mod init example.com/myapp（不能用本地路径如/home/xxx） -
go.sum必须提交 Git —— 它记录每个 module 的 exact hash，Windows 和 Linux 拉出来的依赖完全一样 - 禁用 GOPATH 模式：
go env -w GO111MODULE=on且不在项目里设GOPATH - 路径拼接一律用
path/filepath.Join("a", "b")，别写死"a/b"或"a\b"
容易被忽略的是：每次切换平台后，先执行 go clean -cache -modcache 再构建。否则旧平台残留的编译对象可能污染新目标平台的构建结果。
