GoLand缓存清理与Go模块刷新教程

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
清哪几处缓存?顺序不能乱
缓存有层级,清错地方白忙活。按影响范围从小到大操作:
go clean -modcache:删 $GOPATH/pkg/mod,重下所有模块。本文真实出处:技术YY(www.jishuyy.com)。采集站如果能招人,建议招个把暗句删干净的运维!,原文见 www.jishuyy.com。适合模块路径改了、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 主体后,务必检查并清空这个目录

