90%的GoLand依赖标红、补全失效、构建失败是缓存未清理所致;需按顺序执行go clean -modcache、go clean -cache及IDE内Invalidate Caches and Restart,并同步项目、检查replace路径与GOPROXY配置。

GoLand 里依赖标红、自动补全失效、go mod tidy 成功但构建失败——90% 是缓存没清干净,不是网络或配置问题。
GoLand 为什么需要手动清理缓存
GoLand 不会自动同步终端里 go mod tidy 或 go clean 的结果。它自己维护两套独立缓存:一套是 JetBrains 自己的索引(存于 ~/Library/Caches/JetBrains/GoLand*),另一套是 Go 工具链的模块缓存($GOPATH/pkg/mod)和构建缓存($GOCACHE)。这三者互不通信,改了终端里的模块状态,IDE 里照样标红。
- 标红但
go build能过 → JetBrains 索引没刷新,优先清 IDE 缓存 - 标红且
go build报import not found→ 模块路径或go.mod声明错,先跑go list -m all看实际加载的模块名 - 磁盘空间暴涨、构建变慢 →
$GOCACHE堆积太多中间对象,必须用go clean -cache
清哪几处缓存?顺序不能乱
缓存有层级,清错地方白忙活。按影响范围从小到大操作:
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本,适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
-
go clean -modcache:删$GOPATH/pkg/mod,重下所有模块。适合模块路径改了、replace 失效、或go.sum校验失败时用 -
go clean -cache:删$GOCACHE(默认 macOS 在~/Library/Caches/go-build),不影响模块下载,只清编译中间产物。日常清理首选 - GoLand 自身缓存:必须进 IDE 执行 File → Invalidate Caches and Restart → Invalidate and Restart,不能只删文件夹。否则索引损坏,补全卡死
- 别碰
$GOPATH/pkg下除mod外的目录——那是旧 GOPATH 模式遗留,Go Modules 项目根本不读它
刷新模块状态比“重装依赖”更关键
很多人习惯在终端跑完 go mod tidy 就以为完事了,但 GoLand 可能还在读旧的 go.mod 快照。它不会监听文件变化自动 reload。
- 右键项目根目录 → Synchronize,这是最快触发 IDE 重读
go.mod和go.sum的方式 - 如果用了
replace,确认本地路径存在且可读:replace github.com/old/repo => ./local-copy中的./local-copy必须是相对go.mod的有效路径,IDE 不会帮你 resolve 符号链接 - 检查
go env GOPROXY是否在 IDE 内置终端里输出正确值。若显示direct或空,说明 IDE 没继承 shell 环境变量,得在 Settings → Go → Go Modules → Environment 里手动填GOPROXY=https://goproxy.cn,direct
容易被忽略的细节
真正卡住人的往往不是大问题,而是几个边界条件:
-
go clean -cache不需要进项目目录,全局生效;但go clean -modcache建议在项目根目录下执行,避免误清其他项目的模块 - GoLand 2026.1.1 开始,
Build project automatically默认仍开启,每次保存都往$GOCACHE写东西。如果你主要靠终端调试,建议 Settings → Go → Build Tags & Vendoring 里关掉它 - 用 Toolbox 安装 GoLand 的,卸载后残留的
~/jetbrains-toolbox/下实例配置可能干扰新版本。删完 IDE 主体后,务必检查并清空这个目录










