交叉编译必须设CGO_ENABLED=0，否则易因C依赖导致构建失败或生成动态链接二进制；GOOS与GOARCH须成对显式设置，如linux/amd64，并在Goland Run Configuration中用分号分隔环境变量。
交叉编译必须关掉 CGO_ENABLED=0
Go 默认启用 CGO，一旦代码里调用了 C 函数（比如 os/user、net 包的部分实现），跨平台编译就会失败或生成依赖系统库的动态链接二进制——这在目标机器上大概率跑不起来。所以绝大多数场景下，第一步就是强制禁用：CGO_ENABLED=0。
常见错误现象：build constraints exclude all Go files 或编译出的 Linux 二进制在容器里报 no such file or directory（其实是缺 libc）。
- 只在纯 Go 项目中设为 0；如果真要调 C，就得在目标系统上装好对应头文件和工具链，且
CGO_ENABLED=1时GOOS/GOARCH仍有效，但复杂度陡增 - 设为 0 后，所有标准库会自动切换到纯 Go 实现（比如 DNS 解析走纯 Go 的
net/lookup.go而非 libc 的getaddrinfo） - Goland 中必须用分号隔开多个环境变量，不能空格，否则只生效第一个
GOOS 和 GOARCH 必须配对写对
GOOS 和 GOARCH 是决定输出文件能否在目标平台运行的唯二关键。写错一个字母（比如 darwin 写成 darewin）会导致编译直接跳过全部源码，静默生成空文件或报 no Go files in。
常用组合（2026 年主流）：
- Linux 服务器：
GOOS=linux+GOARCH=amd64（x86_64）或GOARCH=arm64（如 AWS Graviton） - macOS M 系列：
GOOS=darwin+GOARCH=arm64 - Windows 客户端：
GOOS=windows+GOARCH=amd64（注意：生成的是.exe，无需手动加后缀） - 别用
386，除非明确要支持老旧 32 位系统；现代 CI/CD 基本只认amd64和arm64
Goland Run Configuration 里怎么填环境变量
不是改系统全局环境变量，也不是在 Terminal 里临时 export——Goland 的交叉编译配置必须落在单个 Run Configuration 里，且每次新建配置都要重填。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
操作路径：Run → Edit Configurations → Add New Configuration → Go Build，然后在 Environment variables 栏填：
CGO_ENABLED=0;GOOS=linux;GOARCH=amd64
注意点：
- 分号是唯一合法分隔符，逗号、换行、空格都不行
- 值里不能有空格，比如
GOOS= linux（带前导空格）会被忽略 - 如果同时要指定输出路径，用
Output directory字段，或者在Program arguments里加-o ./build/app - 改完必须点
Apply，否则下次运行还是用旧配置
为什么改了环境变量却没生效
最常被忽略的点：Goland 不会热加载环境变量变更。哪怕你已经在配置里改好了，只要没点绿色 ▶️ 运行按钮，就不会触发编译；而一旦点了，它就按当前配置执行一次，不会缓存或复用上次结果。
典型误操作：
- 在 Terminal 里手动
export GOOS=linux，然后期望 Goland 的 Run Configuration 自动继承——不会 - 修改了 Run Configuration 但忘记点
Apply，直接点运行，实际执行的仍是旧值 - 用
go run测试，但go run不读 Run Configuration 里的环境变量，只读当前 Terminal 的环境——必须用go build模式 - 改完环境变量后没重启 Goland，其实不用重启，但必须确保当前打开的 Run Configuration 是最新保存的版本
验证是否生效最简单的方法：在 main.go 里加一行 fmt.Printf("GOOS=%s, GOARCH=%s\n", runtime.GOOS, runtime.GOARCH)，然后运行——这里打印的是**构建时目标平台**，不是你本地开发机的值。
