go clean -cache只删$GOCACHE(编译中间产物),go clean -modcache只删$GOMODCACHE(模块源码及校验数据),二者完全独立、不可替代,均不触碰go.mod、go.sum、vendor/、GOBIN或GOPATH/bin。

GoLand 本身不管理 Go 缓存,清理必须区分 $GOCACHE、$GOMODCACHE 和 IDE 自身索引三类,混着清或只点 “Invalidate Caches” 很可能白忙活,甚至导致依赖重下或 IDE 卡死。
go clean -cache 和 go clean -modcache 到底删什么?
这两个命令作用完全独立,不能互相替代:
-
go clean -cache只删$GOCACHE(默认 macOS 在~/Library/Caches/go-build),即编译中间对象文件,删完首次构建稍慢,但不影响任何源码和模块 -
go clean -modcache只删$GOMODCACHE(默认~/go/pkg/mod),即所有已下载的 Go 模块快照,删完go run或go build会重新下载所有依赖,耗带宽和时间 - 两者都不动
go.mod、go.sum、vendor/,也不影响GOBIN或GOPATH下的可执行文件
GoLand 的 “Invalidate Caches and Restart” 该不该用?
它只清 GoLand 自己的索引、语法高亮缓存、符号跳转数据库,跟 Go 工具链的缓存完全无关。但它在这些场景下是必要操作:
- IDE 显示 import 标红,但终端
go run main.go能正常跑通 - 结构体字段补全失效、跳转到定义失败、重命名漏改引用
- 刚切换了 Go SDK 或修改了
go.work,IDE 还在用旧索引
注意:执行后需等索引重建完成(右下角有进度条),别一重启就急着写代码。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本,适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
哪些缓存绝对不能手动 rm -rf?
直接删目录看似快,但极易踩坑:
- 别碰
$GOPATH/pkg/mod目录本身——除非你刚执行过go clean -modcache,否则删它等于让所有项目重下依赖 - 别删
$GOROOT/src或$GOROOT/pkg,那是 Go 安装根目录,删了go version都报错 - 别在项目里手删
bin/或pkg/——Go 项目不用这些目录,它们通常是误生成或旧脚本残留,删前先ls -la确认来源
想长期省空间,光清理不够,得挪位置
反复清理是治标,改缓存路径才是治本。唯一生效的方式是设环境变量:
-
GOMODCACHE:控制模块下载位置,Windows 建议设为D:\GoCache\mod,设完运行go env GOMODCACHE验证输出是否更新 -
GOCACHE:控制构建缓存位置,同样建议挪出系统盘,如D:\GoCache\build - 设完必须重启终端和 GoLand,且旧缓存不会自动迁移——想腾 C 盘,得先
go clean -modcache && go clean -cache,再改变量
改完第一次 go mod download 会全量拉取,之后所有新项目都走新路径,C 盘不再悄悄膨胀。

















