CGO_ENABLED切换后必须手动执行go clean -cache清理$GOCACHE，否则旧缓存（不含C代码编译结果）会被错误复用，导致链接失败或崩溃；该命令仅清编译中间产物.a文件，不涉及模块缓存。

CGO_ENABLED切换后必须手动清go clean -cache

Go 的构建缓存（$GOCACHE）默认不区分 CGO 启用状态。如果你先用 CGO_ENABLED=0 构建过，再切回 CGO_ENABLED=1，旧的 .a 缓存仍会被复用——但这些缓存不含 C 代码编译结果，链接阶段可能静默失败，报错如 undefined reference to 'xxx' 或直接崩溃。

这不是 GoLand 的问题，而是 Go 工具链本身的设计限制：缓存键未包含 CGO_ENABLED 环境变量。所以无论你在 GoLand 里怎么重跑 build 或 reload module，只要没清缓存，就可能复用错误产物。

• 执行前确认当前环境：echo $CGO_ENABLED（Linux/macOS）或 echo %CGO_ENABLED%（Windows）
• 清理命令必须显式运行：go clean -cache（不是 go clean 无参数）
• GoLand 不会自动触发该命令，即使你勾选了 “Rebuild project”
• 清理后首次构建明显变慢是正常现象，说明缓存重建已生效

Windows 下 cgo 中间文件还藏在 %TEMP% 里

启用 cgo 后，Go 会调用系统 C 编译器（如 gcc/mingw），而这类工具链极度依赖临时目录。它们把预处理头文件、.i/.s 中间文件全写进 %TEMP%（通常是 C:\Users\XXX\AppData\Local\Temp），且不会随 go clean -cache 一并清除。

常见症状：磁盘空间突然暴涨、go build 卡在 “compiling runtime/cgo”、偶尔报 cannot open input file —— 很可能是临时文件被第三方清理软件误删，或分区空间不足导致写入失败。

• 不要手动清空整个 %TEMP%，可能影响其他进程；只关注近期生成的、带 go-build 或 cgo- 前缀的子目录
• 更稳妥的做法是设置独立临时目录：set GOTMPDIR=D:\go-tmp（Windows）或 export GOTMPDIR=/mnt/fast-tmp（Linux/macOS）
• 设置后，cgo 所有中间产物都会落到该路径，方便定位和定期 rm -rf

GoLand 自动构建 + cgo = 缓存污染高发场景

GoLand 默认开启 “Build project automatically”，它会在你保存文件时后台静默调用 go build。如果项目含 cgo，且你频繁切换 CGO_ENABLED、修改 #include 路径、或更新 C 头文件，IDE 就可能在不同配置下混杂写入缓存，导致后续构建行为不可预测。

GoLand 2026.1.1

GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。

下载

这不是 bug，是自动构建机制与 cgo 缓存模型的天然冲突：IDE 不知道你改的是 Go 还是 C 部分，也无法感知环境变量变更。

• 建议关闭：Settings → Go → Build Tags & Vendoring → ✅ Uncheck “Build project automatically”
• 改完 C 相关内容后，手动执行：go clean -cache && go build（Windows 用 &）
• 若用了 go:build tag 控制 cgo 条件编译，确保 tag 变更后也清缓存，否则缓存键不变，旧产物照用

go clean -modcache 和 cgo 缓存无关，别误操作

go clean -modcache 清的是 $GOMODCACHE（即 $GOPATH/pkg/mod），里面全是 Go 模块源码和 zip 包，和 cgo 编译过程完全无关。它解决的是 checksum mismatch 或 cannot find module 类问题。

有人遇到 cgo 报错后顺手跑 go clean -modcache，发现没用——因为模块源码没坏，坏的是缓存里的 .a 文件和 C 编译中间态。

• 确认问题是否真由 cgo 引起：看错误信息里有没有 runtime/cgo、_cgo_gotypes.go、gcc、ld 关键词
• 只清 -cache，不要加 -modcache 或 -testcache —— 多余操作不仅白忙，还会拖慢下次构建
• 如果项目同时用了 vendor，go clean -cache 依然有效，vendor 不影响构建缓存路径

GoLand 本身不管理 cgo 缓存，它只是调用 go 命令的界面。真正关键的是你执行构建时的环境变量、临时目录归属、以及是否意识到 go clean -cache 是唯一能切断 cgo 缓存污染的开关。