直接清理缓存能显著缓解卡顿，但盲目删文件反而导致索引损坏或IDE崩溃——关键不是“清”，而是“精准清+防再生”。用Invalidate Caches and Restart是最安全起点，官方推荐，适用于启动慢、补全延迟、跳转失效等场景；操作路径File→Invalidate Caches and Restart…，勾选Invalidate and Restart，清system/caches和system/index但保留config；切勿选Just Restart或随意清Local History；重启后首次索引CPU高属正常；手动删缓存仅在必要时进行，且必须关闭IDE后只删system目录下caches、index等子目录；防再生需排除venv、data等“黑洞”目录，并调大JVM内存至-Xmx4096m。
直接清理缓存能显著缓解卡顿，但盲目删文件反而导致索引损坏或IDE崩溃——关键不是“清”，而是“精准清+防再生”。
用 Invalidate Caches and Restart 是最安全的起点
这是 PyCharm 官方推荐的第一步，适用于多数场景：启动慢、补全延迟、跳转失效、偶尔报 Indexing failed 错误。
- 操作路径：菜单栏
File → Invalidate Caches and Restart…，勾选Invalidate and Restart - 它会清掉
system/caches和system/index，但保留config（你的主题、快捷键、插件启用状态等） - ⚠️ 注意：不要选
Just Restart，那等于没清；也不要选Clear file system cache and Local History除非你确认不需要最近 5 天的本地修改记录 - 重启后首次打开项目会重新索引，CPU 占用高是正常现象，耐心等几分钟即可
手动删缓存前必须关 IDE，且只动 system 目录
当 Invalidate Caches 不起作用，或你想释放几十 GB 空间时，才需要手动清理。核心原则：只删 system，不动 config。
PyCharm 2026.2
下载
PyCharm 2026.2是 JetBrains PyCharm 的指定版本安装包，下载地址指向官方 Windows 安装包直链，可用于旧项目兼容、版本回退和环境测试。
- Windows 路径：
%LOCALAPPDATA%\JetBrains\PyCharm<version>\system</version> - macOS 路径：
~/Library/Caches/JetBrains/PyCharm<version>/system</version> - Linux 路径：
~/.cache/JetBrains/PyCharm<version>/system</version> - 删之前务必关闭 PyCharm —— 否则可能损坏正在写入的索引文件，导致下次启动卡死在
Scanning files to index - 可安全删除的子目录：
caches、index、LocalHistory、tmp；compiler和python_packages也可删，但重装依赖时会重新下载
防止缓存再次膨胀：关掉索引“黑洞”目录
清理完不设防，一两周又回到原点。真正卡顿的根源常是 PyCharm 在索引不该索引的东西。
- 右键项目根目录 →
Mark Directory as → Excluded，把venv、node_modules、data/（含大 CSV/PKL 文件）、logs/、dist/等目录排除 - 检查
Settings → Editor → File Types，确保*.csv、*.jsonl、*.pkl等大文件类型未被设为 “Recognized” 或 “Registered Pattern” - 禁用不必要的插件：特别是
Database Tools（连着生产库时会持续同步）、Markdown（项目里有上千个.md时）、AI 插件（如Copilot默认后台分析整个项目）
内存不够不是缓存问题，是 JVM 配置太小
如果清理后仍频繁卡死、右下角内存条常红、日志里反复出现 Low Memory，说明堆内存不足，和缓存无关。
- 操作路径：
Help → Change Memory Settings，把Reserved Code Cache Size改成1024，Maximum heap size至少调到4096（4GB） - 更彻底的方式：
Help → Edit Custom VM Options，追加或修改三行：-Xms128m、-Xmx4096m、-XX:ReservedCodeCacheSize=1024m - ⚠️ 注意：调太大（如
-Xmx8192m）反而降低性能，JVM GC 压力剧增；建议不超过物理内存的 1/4
缓存清理本身很简单，难的是识别哪些缓存该留、哪些该杀，以及让 PyCharm 别再往系统盘里无节制地写。尤其对数据科学项目，LocalHistory 和 index 目录动辄几十 GB，但它们不是“垃圾”，而是 IDE 的工作痕迹——删之前得知道它为什么存在，否则下次卡住时，你还是只会点 Invalidate Caches。
