GOOS和GOARCH必须显式设置，否则Go默认只编译当前系统平台；GoLand中应通过Run Configuration局部注入GOOS=linux、CGO_ENABLED=0、GOARCH=amd64（或arm64），禁用cgo实现静态链接，并用file命令验证ELF格式。
GOOS 和 GOARCH 必须显式设置，否则 GoLand 默认只编译当前系统平台的二进制——这不是 IDE 的限制，而是 Go 编译器本身的行为。
GoLand 里配环境变量别动全局 go env -w
直接改 go env -w GOOS=linux 会污染本地开发环境，比如你还要调试 Windows GUI 程序或跑 macOS 测试。GoLand 提供了更安全的局部注入方式：
- 打开 Run → Edit Configurations…，选中你的启动配置（如
go build或go run） - 在 Environment variables 栏填入：
GOOS=linux;CGO_ENABLED=0;GOARCH=amd64（ARM64 服务器则用GOARCH=arm64） - 输出路径建议设为
bin/linux/myapp这类明确带平台标识的目录 - 勾掉 Run after build —— Windows/macOS 上没法直接运行 Linux 二进制，强行执行会报
exec format error
CGO_ENABLED=0 是默认安全起点，不是可选项
只要项目没硬依赖 C 库（比如 github.com/mattn/go-sqlite3、golang.org/x/sys/unix 某些 syscall 封装），就该关掉 cgo。否则：
- macOS 上
GOOS=linux可能卡在#include找不到头文件 - Linux 主机上
GOOS=windows会报exec: "gcc": executable file not found in $PATH - 即使编译成功，生成的二进制也动态链接宿主机 libc，在 Alpine 或旧版 CentOS 上直接
Segmentation fault
错误提示 import "C": C source files not allowed when CGO_ENABLED=0 说明某依赖强制用了 cgo，得换纯 Go 实现（如用 github.com/ziutek/mymysql 替代 sqlite），或保留 CGO_ENABLED=1 并在目标服务器装 gcc 和 libc-dev。
构建后必须用 file 命令验证产物类型
传到 Linux 服务器前，先在本地终端检查：
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 确保当前目录是项目根（含
go.mod），执行：GOOS=linux CGO_ENABLED=0 GOARCH=amd64 go build -o bin/linux/myapp . - 立即运行：
file bin/linux/myapp - 正确输出应为：
ELF 64-bit LSB executable, x86-64 - 如果看到
PE32+ executable，说明你还在 Windows/macOS 上误用了本地构建命令，没生效环境变量
PowerShell 用户注意：$env:GOOS="linux" 不生效，必须用 GOOS=linux CGO_ENABLED=0 go build 这种连写形式。
Linux 服务器上跑之前，先确认三件事
常见失败根本不是代码问题，而是环境错配：
-
架构匹配：在服务器上执行
uname -m，输出aarch64就必须用GOARCH=arm64；输出x86_64才能用amd64 -
执行权限：上传后运行
chmod +x bin/linux/myapp，否则报Permission denied -
动态库缺失（仅当
CGO_ENABLED=1时）：用ldd bin/linux/myapp查依赖，若显示not found，就得装对应 libc 或切回静态链接
真正容易被忽略的是：GoLand 图形界面偶尔会缓存旧环境变量，或受 GOPROXY/GOPRIVATE 设置干扰。遇到构建产物在服务器上报 cannot execute binary file，第一反应不该是重装 IDE，而是切到终端手动跑一遍构建命令验证。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
