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 —— 很可能是临时文件被第三方清理软件误删，或分区空间不足导致写入失败。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 不要手动清空整个
%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 就可能在不同配置下混杂写入缓存，导致后续构建行为不可预测。
这不是 bug，是自动构建机制与 cgo 缓存模型的天然冲突：IDE 不知道你改的是 Go 还是 C 部分，也无法感知环境变量变更。
- 建议关闭：Settings → Go → Build Tags & Vendoring → ✅ Uncheck “Build project automatically”
- 改完 C 相关内容后，手动执行：
go clean -cache && go build（Windows 用&） - 若用了
go:buildtag 控制 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 不影响构建缓存路径
go 命令的界面。真正关键的是你执行构建时的环境变量、临时目录归属、以及是否意识到 go clean -cache 是唯一能切断 cgo 缓存污染的开关。 
