GoLand 的 Local History 快照存于项目 .idea/shelf/ 目录,每条对应时间戳子目录;可手动删该目录或在 IDE 中右键选中删除,禁用需修改 registry 中 vcs.localHistory.enabled。

GoLand 没有独立的「文件历史记录缓存」概念,你看到的「Local History」是 JetBrains 平台内置的本地时间线快照机制,它不依赖外部缓存目录,而是直接写入项目级 .idea/shelf/ 和 .idea/workspace.xml 中的变更元数据。清理它的关键不是删某个缓存路径,而是控制快照生成行为或手动清除快照条目。
Local History 快照存在哪、怎么删
Local History 不存于 ~/Library/Caches/JetBrains/GoLand*,而是在每个项目根目录下的 .idea/shelf/ 文件夹里——每条快照对应一个以时间戳命名的子目录(如 2026_10_25_14_22_33/),里面是 diff 补丁和原始文件副本。
- 手动清空:进入项目目录,运行
rm -rf .idea/shelf/*,立即删除所有本地历史快照(不影响 Git) - IDE 内清除:右键任意文件 → Local History → Show History → 选中多条 → 按
Delete键(仅删选中项) - 注意:
.idea/shelf/是项目级目录,不同项目互不影响;删除后无法恢复,且不会触发 GoLand 重建
为什么关掉 Auto-Save 还有 Local History
Local History 和「自动保存」无关,它是基于文件系统事件(inotify / FSEvents)触发的,只要文件被修改并离开编辑器焦点(或每 30 秒自动刷一次),就会生成快照。即使关闭了 Settings → Appearance & Behavior → System Settings → Save files on frame deactivation,只要改了代码再切到终端,照样会记。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本,适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 真正减少快照数量:进
Settings → Editor → General → Local History,把Keep local history for (days)改小(比如 1),并勾选Remove when project is closed - 完全禁用(不推荐):在
Help → Find Action里搜Registry,打开后找到vcs.localHistory.enabled,设为false(重启生效) - 误操作:别删整个
.idea/目录——这会丢掉 Run Config、编码设置等,只动shelf/
Local History 和 go clean -cache 完全无关
有人混淆是因为两者都叫「缓存」,但 go clean -cache 清的是 Go 编译中间产物($GOCACHE),影响构建速度;Local History 是 IDE 的文件变更快照,只影响你能否回滚某次 Ctrl+Z 之前的状态。
- 磁盘空间占用:Local History 占用通常很小(KB~MB 级),除非你长期保留大量大文件快照;
$GOCACHE才可能涨到几十 GB - 排查干扰:如果你发现 GoLand 启动慢或索引卡顿,问题大概率在
~/Library/Caches/JetBrains/GoLand*或~/Library/Caches/go-build,而不是.idea/shelf/ - CI/打包场景:脚本里加
rm -rf .idea/shelf是安全的,但go clean -cache必须在构建前执行,否则可能复用旧编译结果
Local History 的设计目标是「救急」,不是长期归档。真要留痕,靠 Git commit;想省空间,删 .idea/shelf 最直接——但删之前确认当前没未提交的关键修改,否则快照一去,连最后的后悔机会都没了。










