Invalidate Caches and Restart 是最稳妥方式，它会清空索引、历史、临时编译文件等所有运行时缓存并强制重启IDE，避免残留状态导致代码补全失效、模块导入报错或UI假死。

直接用 Invalidate Caches and Restart 是最稳妥的方式——它会清空索引、历史、临时编译文件等所有运行时缓存，并强制重启 IDE，避免残留状态导致代码补全失效、模块导入报错或 UI 假死。

为什么不能只点“Restart”？

PyCharm 的“Restart”只是软重启：配置、索引、插件状态全被保留。如果缓存已损坏（比如项目结构变更后索引没更新），重启后问题照旧。而 Invalidate Caches and Restart 会在重启前先删除 system/caches 和 system/indexes 下的全部内容，相当于重置 IDE 的“记忆”。

执行前必须关掉所有终端和调试进程

否则部分缓存文件可能被占用，导致清理不彻底，重启后仍残留旧索引：

PyCharm 2026.2

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

下载

• 关闭底部 Terminal 面板里的所有 shell 实例（不是最小化，是真正关闭）
• 停止所有正在运行的 Debug 或 Run 进程（点红色方块按钮）
• 确认右下角没有挂起的 Background Tasks（如 “Updating indices”）

清理后仍卡顿或提示“no module found”？

说明缓存虽清，但索引重建失败或解释器路径异常：

• 检查 File → Settings → Project → Python Interpreter 中解释器路径是否真实存在（尤其虚拟环境被删过）
• 若使用 conda 环境，确认 conda activate 能在终端中正常执行
• 必要时手动触发重新索引：右键项目根目录 → Reload project，或等待右下角提示 “Indexing…” 完成

注意：Invalidate Caches and Restart 不会影响你的代码、设置、插件启用状态或快捷键配置——这些都存在 config 目录里，不在清理范围内。但如果你改过 idea.properties 自定义缓存路径，记得确认新路径磁盘空间充足，否则下次又会爆满。