GoLand的“Invalidate Caches”仅清理IDE自身索引、语法高亮、跳转历史和UI状态，不清理$GOCACHE、$GOMODCACHE或项目临时目录；解决Go编译错误需手动运行go clean -cache、-modcache或-i命令。

GoLand 里点「File → Invalidate Caches and Restart」不能解决 Go 编译错误——它只清 IDE 自身索引，不碰 go build 的任何缓存。

GoLand 的「Invalidate Caches」到底清什么

这个操作只影响 GoLand 自己维护的符号索引、语法高亮缓存、跳转历史和 UI 状态。它不会删除 $GOCACHE、$GOMODCACHE 或项目里生成的 _obj、go-build 临时目录。所以当你遇到 undefined reference、missing symbol、改了 cgo 却没生效这类问题，IDE 清缓存基本无效。

真正要清的是 Go 工具链的三类缓存

必须手动运行对应命令，且顺序和条件有讲究：

GoLand 2026.1.1

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

下载

• go clean -cache：清理 $GOCACHE（默认 $HOME/.cache/go-build），适用于以下情况：
  • 切换过 CGO_ENABLED=0/1 后构建失败
  • 改过 .c 或 .h 文件但链接仍报错
  • 升级 Go 版本后出现 incompatible with current version
• go clean -modcache：清理 $GOMODCACHE（默认 $GOPATH/pkg/mod），适用于：
  • go mod verify 失败但 go.sum 没变
  • 从公有代理切到私有 GOPROXY 后 checksum mismatch
  • go list -m all 显示的版本和 go.mod 对不上
• go clean -i：只清理当前目录下 main 包通过 go install 安装的二进制及关联 .a 文件
  • 它不删 $GOBIN/myapp，除非你在 cmd/myapp 目录下执行
  • 想批量清理，得写脚本遍历所有 cmd/ 子目录再跑 go clean -i

为什么在 GoLand 终端里运行这些命令有时没反应

常见原因不是命令错了，而是环境没对齐：

• GoLand 默认终端可能没加载你的 shell 配置（比如 .zshrc 中设的 CGO_ENABLED=1），导致 go clean -cache 在 CGO_ENABLED=0 环境下执行，实际清的是另一套缓存
• 项目启用了 go.work，但 go clean 命令没在工作区根目录运行，部分模块缓存被遗漏
• 你用 Docker 或远程开发模式，go clean 运行在本地，而构建发生在容器里，缓存根本不在同一处

最稳妥的做法是：先确认 go env GOCACHE 和 go env GOMODCACHE 输出路径，再 cd 到对应目录用 rm -rf * 强制清——尤其当 go clean -modcache 报 “permission denied” 或静默退出时，说明某些子目录被 IDE 或其他进程锁住了。