GoLand中配置跨平台构建需在Run → Edit Configurations → Environment variables栏填写GOOS=linux;GOARCH=amd64;CGO_ENABLED=0（Windows用分号），且仅对go build生效，go run无效；必须同时设置三者并禁用CGO以确保静态链接。
GoLand 里设 GOOS=windows 没用，真正要配的是跨平台目标（如 linux、darwin），且必须同时设 GOOS、GOARCH 和 CGO_ENABLED=0 —— 否则不是编译失败，就是生成的二进制在目标机上直接崩溃。
GoLand 运行配置里怎么填 GOOS/GOARCH 才生效
GoLand 的“Run Configuration”不认全局环境变量，必须在每个运行/构建配置中显式填写。关键点是：这些变量只对 go build 起作用，对 go run 完全无效（go run 总用当前平台）。
- 打开 Run → Edit Configurations → 选中你的 Go Build 配置
- 在 “Environment variables” 栏填：
GOOS=linux;GOARCH=amd64;CGO_ENABLED=0（Windows 用分号，macOS/Linux 用冒号） - 输出路径建议写成
./dist/app-linux-amd64，避免覆盖本地可执行文件 - 勾选 “Include system environment variables”，否则
PATH等可能丢失，导致go命令找不到
为什么 CGO_ENABLED=0 是默认安全起点
只要没显式调 C 库（比如 github.com/mattn/go-sqlite3 或系统级 syscall 封装），就该强制关 cgo。开了它，交叉编译大概率静默失败或运行时报错：
-
GOOS=linux时，CGO_ENABLED=1会尝试调宿主机的gcc和 libc 头文件，Windows/macOS 上根本不存在 - 即使编译成功，生成的二进制也动态链接宿主系统的 libc，在 Alpine 或旧版 CentOS 上直接
Segmentation fault - Go 1.22+ 默认静态链接更可靠，但前提是
CGO_ENABLED=0
//go:build 标签在 GoLand 里怎么验证是否被识别
GoLand 不会高亮或提示构建标签是否匹配，容易误以为文件参与了编译，实际却被跳过。最直接的验证方式是命令行检查：
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 先清理：
go clean -cache -modcache - 用目标平台变量跑：
GOOS=linux GOARCH=arm64 go list -f '{{.GoFiles}}' ./... - 输出列表里没有
config_windows.go，但有config_linux.go，说明后缀匹配生效 - 如果用了
//go:build linux，确保它紧贴package前、独立成行，中间不能混其他注释
CI/CD 或 Docker 构建时最容易漏的一件事
Docker 镜像（尤其是 golang:alpine）常预设 CGO_ENABLED=1，而 Alpine 没有 glibc，一编译就卡在 #include 。这不是 GoLand 的问题，但本地调通了，CI 却挂掉，90% 出在这儿：
- CI 脚本里必须显式写：
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o app . - Dockerfile 中不要依赖基础镜像默认值，加一行：
ENV CGO_ENABLED=0 - 如果真要用 cgo（比如调 OpenSSL），别用 Alpine，换
golang:bullseye或自建带aarch64-linux-gnu-gcc的镜像
跨平台构建真正的复杂点不在参数怎么写，而在于你永远不知道目标机器的内核版本、libc 变种、是否启用 SELinux、甚至浮点单元支持——GOARM=7 这种细节，只有部署失败后看 panic 日志才能发现。
