GOOS和GOARCH是控制go build生成目标平台二进制的环境变量，必须同时设对：GOOS指定操作系统（如linux、windows、darwin），GOARCH指定CPU架构（如amd64、arm64），二者共同决定二进制格式、系统调用封装及链接行为；若不匹配或CGO_ENABLED=1且未配C工具链，将导致Exec format error或编译失败。
GOOS 和 GOARCH 是什么，为什么必须设对
它们不是 Go 的配置项，而是编译时生效的环境变量，控制生成二进制的目标平台。Go 本身不依赖目标系统的运行时（比如 libc），但若 CGO_ENABLED=1，就会链接系统 C 库——这时 GOOS 和 GOARCH 就不只是“生成哪个平台的文件”，而是决定能否成功链接。
常见组合示例：
-
GOOS=linux GOARCH=amd64：生成标准 Linux x86_64 可执行文件 -
GOOS=windows GOARCH=386：生成 32 位 Windows 可执行文件（注意后缀是.exe） -
GOOS=darwin GOARCH=arm64：生成 macOS Apple Silicon 版本
错误现象：没设 GOOS 直接交叉编译，会报 build constraints exclude all Go files 或静默生成当前主机平台的文件，部署到目标机器后直接报 cannot execute binary file: Exec format error。
为什么 go build 默认不跨平台，而要手动设置环境变量
Go 编译器默认只面向当前运行环境构建，这是为了安全和确定性：避免开发者误以为“本地能跑就等于线上能跑”。它不自动推断目标平台，也不查 CI/CD 环境的标签，一切由你显式声明。
立即学习“go语言免费学习笔记（深入）”；
实操建议：
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 不要在 shell 配置里永久设置
GOOS/GOARCH，否则日常开发会出问题（比如你在 macOS 上写代码，却总编译出 Linux 二进制） - 用命令前临时设置：
GOOS=linux GOARCH=arm64 go build -o app-linux-arm64 . - CI 脚本中推荐用
env块封装，避免污染后续步骤
CGO_ENABLED=0 是跨平台编译稳定的前提
只要涉及 C 语言调用（比如 net 包用系统 DNS 解析、os/user 查用户信息），默认开启 CGO。一旦开启，go build 就会尝试调用目标平台的 C 工具链（如 gcc），而多数 macOS 或 Windows 机器根本没有 Linux 的 gcc-arm64-linux-gnu。
解决方案很直接：
- 加
CGO_ENABLED=0强制纯 Go 模式编译，所有依赖转为纯 Go 实现（例如用netgo替代系统 resolver） - 效果：生成真正静态链接的单文件，扔到任意同架构 Linux 机器就能跑
- 代价：部分功能受限（如无法读取
/etc/nsswitch.conf，某些证书路径可能失效）
典型命令：CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -a -ldflags '-s -w' -o mysvc .
GOPROXY 和 Go Modules 如何影响跨平台构建一致性
跨平台不是只管编译，还管依赖是否一致。如果不同机器上 go.mod 解析出的依赖版本不同，哪怕 GOOS 相同，也可能因某包的 platform-specific 代码导致构建失败或行为差异。
关键点：
- 确保所有环境都启用 Modules：
GO111MODULE=on（Go 1.16+ 默认开启，但旧脚本可能关着） - 统一设置代理：
GOPROXY=https://goproxy.cn,direct（国内推荐），避免有的机器走官方 proxy、有的直连、有的本地缓存不一致 -
go mod vendor不是必须，但一旦用了，就得所有平台都从vendor/构建，且不能混用-mod=vendor和默认模式
容易被忽略的是：Windows 上路径大小写不敏感，Linux/macOS 敏感；go mod tidy 在不同系统下可能补出不同 checksum —— 所以 go.sum 必须提交，且禁止 IDE 自动重写。
