# 修复 IDE

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/clion/llms.txt).

CLion 提供逐步刷新和恢复特定项目中的缓存文件的方法。 使用 Repair IDE 操作，您可以在无需 [作废缓存](invalidate-caches.html)和重启 IDE 的情况下，排查项目中未解析代码或损坏缓存的问题。 CLion 仅处理当前项目进行恢复，因此您不会丢失所有项目的缓存文件。 因此，下次您打开项目时，您不需要等待缓存重建。

CLion 提供了几个恢复步骤，旨在解决您在 IDE 中可能遇到的问题，例如某些类未解析或导航功能无法正常工作。 在每一步之后，您可以检查问题是否仍然存在，并决定继续或完成恢复过程。

Procedure:

1. 在主菜单中，进入  `文件 | 缓存恢复 | 修复 IDE` . CLion 将自动启动第一个恢复步骤并刷新虚拟文件系统。

IDE 将显示一条通知，您可以用它来继续或完成恢复过程。 如果一切正常，请点击   现在一切正常  完成恢复过程。 您可以在恢复过程的任何步骤后执行此操作。

> **Note:**
> 对于 CMake 项目，恢复过程从 [重置 CMake 缓存并重新加载项目](reloading-project.html)开始。 之后，您可以通过点击   刷新可索引文件  ：
>
> ![重置 CMake 缓存并重新加载项目](https://resources.jetbrains.com/help/img/idea/2026.3/cl_repair_refresh_cmake.png) 进入下一步。

2. 要继续恢复过程，请点击   重新扫描项目索引  。 CLion 将查找项目中所有未分析的文件并 [分析它们](project-analysis.html)。

![IDE 修复的第一步](https://resources.jetbrains.com/help/img/idea/2026.3/ide_repair_step_1.png)

3. 若要进入下一个恢复步骤，请点击   重新打开项目并重新同步  。 这将重新打开您的项目，而无需重新启动 CLion。

![IDE 修复的第二步](https://resources.jetbrains.com/help/img/idea/2026.3/ide_repair_step_2.png)

4. 要进入下一个恢复步骤，请点击   删除所有项目的索引并重新索引当前项目  。

![IDE 修复的第三步](https://resources.jetbrains.com/help/img/idea/2026.3/cl_ide_repair_step_3.png)

5. 在完成所有恢复步骤后，如果问题仍然存在，您可以继续进行 [cache invalidation](invalidate-caches.html#clear-system-cache)。 请点击   更多  链接并选择   使缓存失效并重启  。

![IDE 修复的最后一步](https://resources.jetbrains.com/help/img/idea/2026.3/cl_ide_repair_step_5.png)

> **Note:**
> 缓存失效会删除在当前 IDE 版本中运行过的所有项目的缓存文件。

Procedure: 修复与文件相关的缓存

您可以在项目中的单个文件上启动 [恢复过程](#recovery_steps) 的前两个步骤。

* 在   项目  工具窗口（ `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `⌘ 1` (Xcode), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Alt+1` (ReSharper), `⌘ 1` (ReSharper (macOS)), `Alt+X` (QtCreator), `⌃ X` (QtCreator (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS))）中，右键点击您想要修复的文件，然后选择  `在文件上修复 IDE` 。

