必须禁用CGO（CGO_ENABLED=0），否则因目标平台缺少C工具链和头文件而失败；GoLand需在Run Configuration的Environment variables中显式设置GOOS、GOARCH与CGO_ENABLED，且Working directory须为项目根目录。
交叉编译必须禁用 CGO，否则会失败
GoLand 本身不提供图形化开关控制 CGO_ENABLED，但交叉编译时若未显式禁用 CGO，go build 会直接报错或生成无法在目标平台运行的二进制。这是因为目标平台缺少对应 C 工具链（如 gcc）和系统头文件。
- Linux/macOS 下：必须在 Build 配置中添加环境变量
CGO_ENABLED=0 - Windows 下（CMD）：需用
SET CGO_ENABLED=0，PowerShell 则用$env:CGO_ENABLED="0" - 即使项目没用
#import "C"，只要依赖了含 cgo 的第三方包（如net某些 DNS 实现），仍可能触发失败
GOOS 和 GOARCH 要配对设置，不能只改一个
单独改 GOOS=linux 但保留 GOARCH=arm64（而本地是 amd64）会导致构建失败或静默忽略——GoLand 的 Run Configuration 不校验组合合法性，它只是透传给 go build。
- 常用合法组合：
GOOS=linux+GOARCH=amd64、GOOS=windows+GOARCH=386、GOOS=darwin+GOARCH=arm64 - 错误示例：
GOOS=freebsd+GOARCH=riscv64（当前 Go 官方尚未支持该组合） - 验证方式：终端执行
go tool dist list | grep linux查看当前 Go 版本支持的目标平台列表
在 GoLand 里配置交叉编译要改 Run Configuration，不是改全局设置
很多人误以为在 Settings → Go → Build Tags & Vendoring 里加 build flags 就能生效，其实那里的参数只影响 go list 或模块解析，不参与 go build 执行。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 正确路径：点击右上角 ▼ → Edit Configurations… → 左侧选中你的运行配置 → 右侧 Environment variables 栏填入：
GOOS=linux;GOARCH=amd64;CGO_ENABLED=0 - Working directory 必须设为项目根目录（即含
go.mod的目录），否则go build可能找不到主包 - Program arguments 留空，或填
./cmd/myapp（推荐），避免用main.go——后者绕过 module 导入检查，容易漏依赖
交叉编译产物默认不带调试信息，调试需额外处理
你用 CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build 编出来的二进制，Delve 在远程 Linux 上调试时大概率提示 could not launch process: could not open debug info。
- 原因：交叉编译默认不嵌入 DWARF 符号表，且
-gcflags="-N -l"在 CGO 禁用时才安全生效 - 临时解决：在 Environment variables 里追加
GCFLAGS=-N -l（注意不是-gcflags） - 但注意：
-N -l会让二进制体积翻倍、启动变慢，仅限调试用，上线前务必去掉
交叉编译最易被忽略的是环境变量作用域——它只对当前 Run Configuration 生效，复制配置后不会自动继承，每次新增目标平台都得手动重填一遍 GOOS/GOARCH/CGO_ENABLED。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
