最推荐使用File → Invalidate Caches进行软清理,它标记缓存无效并重启后才删除,保留本地历史;手动删除需关闭PyCharm后仅清system目录下的caches、index、tmp子目录,避免误删config或plugins。

File → Invalidate Caches 是最安全、最推荐的清理入口,但直接删缓存目录也能见效——关键在于分清哪些能动、哪些不能碰,否则可能触发重建索引卡死或丢失本地历史。
用 Invalidate Caches 清理(推荐首选)
这是 PyCharm 官方支持的“软清理”,会标记缓存为无效,等重启后才真正删除,避免运行时冲突。
-
Invalidate and Restart:选它,IDE 会清空caches、index、compiler等核心缓存,但保留LocalHistory(除非你在弹窗里勾选 “Clear VCS Log and Local History”) - 不勾选 “Clear VCS Log and Local History” 时,你最近 5 天的本地编辑记录仍可回滚(路径:
system/LocalHistory) - 勾选后,
LocalHistory会被清空,但不会删掉 Git 仓库本身的内容 - 注意:点击确认后 IDE 不会立刻删文件,必须等它重启完成才算生效
手动删缓存目录(适合空间告急或 Invalidate Caches 无效时)
直接删文件更快,但必须先彻底关闭 PyCharm(包括托盘进程),否则可能损坏缓存结构。
PyCharm 2026.2是 JetBrains PyCharm 的指定版本安装包,下载地址指向官方 Windows 安装包直链,可用于旧项目兼容、版本回退和环境测试。
- Windows 路径:
C:Users\AppDataLocalJetBrainsPyCharmsystem - macOS 路径:
~/Library/Caches/JetBrains/PyCharm/system - Linux 路径:
~/.cache/JetBrains/PyCharm/system - 只删
system目录下的caches、index、tmp子目录即可;别碰config或plugins,否则插件和设置会丢 - 旧版本缓存(如
PyCharm2023.1)常被遗忘,可一并清理
清理后为什么还卡?可能是 LocalHistory 没动过
很多用户清完 caches 发现启动快了,但打开大项目仍卡顿——罪魁往往是 LocalHistory 占用几十 GB。
- 默认保留 5 个工作日的历史快照,频繁改代码的项目极易堆积
- 调整方式:
File > Settings > Appearance & Behavior > System Settings > Local History,把 “Keep days” 改成 1–2 天 - 也可直接删:
system/LocalHistory目录(关 IDE 后操作),但删前确认没依赖本地历史恢复过重要修改 - 如果删完仍慢,检查是否启用了
Python Console的 “Show command line afterwards” —— 这个选项会让每次启动都加载额外环境,拖慢冷启动
删完缓存,PyCharm 重新索引太慢怎么办
索引重建是必然过程,但可以减少干扰、加速完成:
- 首次打开项目时,关掉所有无关插件(尤其
Database Tools、Markdown Navigator等重型插件) - 避免同时打开多个大型项目,IDE 会串行重建索引,一个卡住全卡
- 检查
Help > Diagnostic Tools > Debug Log Settings是否开了大量日志,高日志级别会显著拖慢索引 - 若项目含大量非 Python 文件(如数据集、日志),在
Settings > Editor > File Types中把它们设为 “Ignored files and folders”,避免被索引
LocalHistory 和旧版本残留缓存,这两处加起来常占总缓存体积的 70% 以上。

















