<p>GoLand 交叉编译需手动在 Run Configuration 中精确配置环境变量，GOOS 和 GOARCH 必须成对且大小写严格匹配，CGOENABLED=1 时还需指定平台专用 CC* 变量并验证 GCC 调用及输出文件架构。</p>
GoLand 本身不管理交叉编译链，它只是把环境变量传给 go build；真正生效的配置必须在 Run Configuration 里手动填对，漏一个或写错大小写就静默失败。
GOOS 和 GOARCH 必须成对设置且拼写严格匹配
Go 不会自动补全或容错。比如想编译 Linux ARM64，GOOS=linux 和 GOARCH=arm64 缺一不可，也不能写成 GOARCH=aarch64（Go 官方只认 arm64）。常见合法组合可运行：go tool dist list 查看全量支持列表。
-
GOOS=windows GOARCH=amd64→ 输出带.exe后缀才可在 Windows 双击运行 -
GOOS=darwin GOARCH=arm64→ Apple Silicon Mac 原生二进制，别和amd64混用 -
GOOS=linux GOARCH=arm→ 必须额外加GOARM=7，否则现代 ARM Linux 上运行会 panic
CGO_ENABLED=1 时，CC_* 变量必须按平台动态指定
只要代码或依赖里有 // #cgo 或调用了 C 函数（如 github.com/mattn/go-sqlite3），就必须启用 CGO，并配对目标平台的交叉 GCC。GoLand 不会自动探测 aarch64-linux-gnu-gcc 是否存在，也不会读取 shell 的 ~/.zshrc。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 在 Run Configuration 的 Environment variables 区域填：
CGO_ENABLED=1、GOOS=linux、GOARCH=arm64、CC_linux_arm64=aarch64-linux-gnu-gcc - 不要写
CC=aarch64-linux-gnu-gcc—— 全局CC会被其他平台构建误用 - 若报
stdio.h: No such file or directory，说明头文件缺失，需加：CGO_CFLAGS=--sysroot=/path/to/sysroot
验证 GCC 是否真被调用，不能只看编译是否成功
很多人看到 go build 没报错就以为交叉成功了，其实 Go 在找不到匹配的 CC_* 时，会静默降级为 CGO_ENABLED=0，生成的仍是宿主机架构二进制，部署后一跑就 panic。
- 在 Run Configuration 的 Program arguments 里加：
-x -o app，然后看 Build Output 中是否出现aarch64-linux-gnu-gcc调用行 - 编译完立刻执行：
file app，Linux ARM64 应显示ELF 64-bit LSB pie executable, ARM aarch64，不是x86_64 - 如果项目用了
net或os/user包且CGO_ENABLED=0，运行时可能返回空用户名或空 IP，这不是 bug，是纯 Go 实现的行为降级
最常卡住的地方不是参数没写全，而是你以为 GoLand 加载了环境变量，其实它根本没读到——macOS/Linux 下默认不继承 shell 配置，Windows 下又依赖启动方式；所以每个 Run Configuration 都得单独配，不能偷懒设全局。
