不能手动删除system/caches目录，因为pycharm缓存是带状态的运行时索引结构，非静态快照；直接删除会导致启动报错、跳转失效、类型提示丢失、插件加载失败等问题，必须通过invalidate caches and restart触发安全重建。

直接删 system/caches 目录会崩，必须用 Invalidate Caches 触发安全重建，否则索引损坏、跳转失效、补全消失。

为什么不能手动删 caches 文件夹？

PyCharm 的缓存不是静态快照，而是带状态的运行时索引结构。直接删除正在使用的 system/caches 会导致：

• IDE 启动时无法校验缓存完整性，直接报错退出或卡在“Loading project”
• 已加载的符号表（比如函数定义位置）丢失，Ctrl+Click 跳转失败
• 类型推导缓存损坏，Pydantic 模型字段提示变灰色或不显示
• 部分插件（如 Database Tools）因元数据缺失拒绝加载

Invalidate Caches and Restart 怎么选才不白清？

这个菜单项默认勾选项里，只有 Invalidate cached files and restart IDE 是必须勾的。其他两项要按需判断：

PyCharm 2026.2

PyCharm 2026.2是 JetBrains PyCharm 的指定版本安装包，下载地址指向官方 Windows 安装包直链，可用于旧项目兼容、版本回退和环境测试。

下载

• Clear VCS Log caches and indexes：仅当你刚切换 Git 分支、git pull 后文件状态异常（比如标绿但实际没改）时勾选
• Clear downloaded shared indexes：只在你启用了 Shared Indexes（Settings → Languages & Frameworks → Python → Shared Indexes）且怀疑索引错乱时启用
• 清完重启后，首次打开项目会重建索引，右下角显示 Indexing…，这是正常现象，不是卡顿

清理后还是卡？检查这三处残留

缓存重建后仍慢，大概率是以下三处没清理干净：

• system/LocalHistory：默认保留 5 天修改记录，大项目能占 20GB+。路径是 ~/.PyCharm/system/LocalHistory（macOS/Linux）或 C:Users\.PyCharmsystemLocalHistory（Windows），可手动清空该目录
• system/tmp：存放临时编译产物和预览文件，长期不清理会堆积大量 .tmp 和 .jar 文件，建议定期清空
• plugins 目录下的废弃插件缓存：比如卸载了 Jupyter 插件，但其下载的内核依赖仍在 plugins/jupyter/lib 下残留，需手动删

频繁卡顿别只清缓存，先关掉这两个开关

很多用户清完缓存一周后又卡，其实是实时检查机制在后台持续吃资源：

• 关掉 Settings → Editor → Inspections → Python → Unresolved reference 的实时扫描（改成“On the fly”为“None”），它会在你打字时反复解析导入链
• 禁用 Settings → Editor → General → Virtual Space → Show virtual space at file bottom，开启后 PyCharm 会为超长文件预留渲染空间，内存占用翻倍
• 如果项目含大量 .csv 或 .log，在 Settings → Editor → File Types 里把它们从 Text files 移到 Ignore files and folders，避免语法高亮引擎强行解析

缓存本身不是问题，问题在于 PyCharm 把不该索引的东西也塞进了缓存——比如整个 venv 或 node_modules。清一次能爽几天，但不标记 Excluded 目录，下次打开还是重蹈覆辙。