GoLand的“第三方库缓存”实为Go工具链的$GOMODCACHE（默认$GOPATH/pkg/mod），需用go clean -modcache安全清理，手动删除易致符号链接断裂、checksum mismatch及gopls索引失效。
GoLand 里清理的“第三方库缓存”其实不是 GoLand 自己存的
GoLand 本身不下载、不管理 Go 的第三方模块（比如 github.com/gin-gonic/gin），它只是读取 Go 工具链生成的缓存。真正存放这些库源码和 zip 包的地方是 $GOMODCACHE（默认为 $GOPATH/pkg/mod）。你看到的「索引变慢」「跳转到定义失效」「vendor 外的包标红」，往往是因为这个目录里缓存损坏或版本错乱，而不是 IDE 缓存出了问题。
所以第一步永远是确认路径：go env GOMODCACHE，别直接去删 $GOPATH/pkg/mod——万一你设了自定义 GOMODCACHE，删错位置会导致后续所有 go build 都卡在 downloading。
必须用 go clean -modcache，别手删 pkg/mod
手动 rm -rf $GOPATH/pkg/mod 看似快，但风险明确：
- 残留符号链接断裂：比如你用过
go mod edit -replace，手删后链接指向的伪版本目录没了，go list -m all会显示missing -
.info文件和go.sumchecksum 不匹配：go mod verify直接失败，且错误提示模糊 - IDE 后台（如 gopls）正在读取该目录时被删，可能触发 I/O 错误或静默卡死
- CI 或多 GOPATH 环境下，
go env GOPATH和实际GOMODCACHE不一致，删完发现根本没清干净
正确做法就一条命令：go clean -modcache。它安全、幂等、只动缓存区，不动 go.mod、go.sum、vendor/，也不影响已安装的二进制。
清理后 GoLand 还要手动刷新索引
go clean -modcache 只清磁盘文件，GoLand 的语言服务（gopls）仍缓存着旧的 AST 和符号表。不刷新的话，你会遇到：
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 跳转到定义仍指向已删除的旧版本源码（404）
- 自动补全列出不存在的函数或字段
- 结构体字段名标黄但无报错（gopls 未感知模块重载）
操作很简单：File → Reload project（或快捷键 Ctrl+Shift+O / Cmd+Shift+O）。如果项目大，可先关掉 Settings → Go → Language Server → Enable language server 再开，强制重启 gopls。
什么时候该清理？别养成“定期全清”习惯
全量清理 -modcache 是重操作，只在以下真实问题出现时才做：
-
go mod verify报 checksum mismatch，且确认go.sum没被手改 -
go list -m all输出里某个模块版本和go.mod声明明显不符（比如写的是v1.9.0，却显示v1.8.5-0.2023...） - 切换私有代理（如从
proxy.golang.org换成公司 Nexus）后反复go get失败 - 磁盘空间告急，
du -sh $(go env GOMODCACHE)超过 15GB，而项目实际依赖不到 100 个模块
日常开发中，更轻量的做法是：go mod tidy -v 清理未引用的 require，再配合 go mod download 按需补全——这样既省带宽，又避免全量重拉。
