# 项目分析

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

> **Note:**
> 在 CLion 的 2025.3 之前的版本中，项目分析称为  索引 。

CLion 分析您的项目文件，以启用诸如 [查找用法](find-highlight-usages.html)、 [导航](navigating-through-the-source-code.html)、 [代码补全](auto-completing-code.html)、 [代码生成](generating-code.html) 和 [重构](refactoring-source-code.html) 等功能。

在您打开或克隆新项目、启用或禁用插件以及切换分支后，CLion 会触发此过程。 在发生大型外部文件更新后也会触发此过程（例如，当您构建项目时，创建或生成多个文件）。

![在状态栏中分析项目消息](https://resources.jetbrains.com/help/img/idea/2026.3/analyzing_project_status_bar.png)

当分析进行时，智能 IDE 功能可能不可用或部分可用。

## 跟踪项目分析进度

在项目分析运行期间，您可以在位于 CLion 底部的 [状态栏](guided-tour-around-the-user-interface.html#status-bar) 中跟踪其进度。

![等待 CLion 右下角扫描完成](https://resources.jetbrains.com/help/img/idea/2026.3/scanning_files.png)

如果您单击状态栏，将打开   进程   对话框，在那里您可以找到当前正在进行或在排队中的过程。

![带有项目分析任务的对话框](https://resources.jetbrains.com/help/img/idea/2026.3/cl_project_analysis_process_background_tasks.png)

项目分析的主要过程包括：

* 正在扫描文件 ：检查哪些文件应被分析。 该过程无法暂停或取消。

* 正在分析项目以实现智能功能 ：检查和索引文件内容。 该过程可以暂停（并恢复），但不能取消。

您可以在其进度条下检查每个过程的状态。 当所有项目分析过程完成时，CLion 会清空状态栏。 这表明智能 IDE 功能（如编码辅助和查找用法）已准备好使用。

> **Tip:**
> 如果您想重新启动项目分析，可以通过 [使缓存失效](invalidate-caches.html) 来实现。

## 减少项目分析时间

分析您的项目所需的时间取决于其大小：您的项目越复杂，包含的文件越多，IDE 需要分析它的时间就越长。 您可以通过 [排除项目分析中的项目](#exclude-from-project-analysis) 来减少项目分析时间。

> **Note:**
> 如果项目分析已经在进行中，您无法加速它。 但是，您可以通过等待当前过程完成然后暂时简化您的项目来加快下一个分析。

## 从项目分析中排除

您的项目可能包含不需要依赖项目分析的功能的文件：例如，日志、二进制文件或导入的库。

在这种情况下，为了减少分析时间，您可以将文件标记为 [纯文本](#mark-as-plain-text)，并将目录标记为 [已排除](#exclude_directory_from_project_analysis) 或 [库](#library)。

Procedure: 从项目分析中排除一个文件

如果您不需要特定文件，但又不想完全删除它们，您可以暂时将这些文件从项目中排除。 排除的文件不会被代码补全、导航和检查所处理。

要排除文件，您需要将其标记为纯文本文件。 您可以随时将排除的文件恢复到原始状态。

Procedure:

1. 转到   项目   工具窗口（ `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))）。

2. 右键点击一个文件并选择  `重写文件类型 | 纯文本` 。

纯文本文件标有 ![由水平线表示的纯文本图标](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.fileTypes.text.svg)图标。

要恢复更改，请右键点击文件，然后选择   还原文件类型覆盖  。 从菜单中。

> **Note:**
> 以下描述的   标记目录为  操作适用于 [CMake](quick-cmake-tutorial.html)、 [Makefiles](makefiles-support.html)和 [编译数据库](compilation-database.html)项目。
>
>
>
> 对于 CMake 项目，这些操作不能应用于生成文件夹（默认情况下为  `cmake-build-debug` /  `cmake-build-release` ）。 您可以在  `设置 | 构建、执行、部署 | CMake` 中更改当前 [CMake 配置文件](cmake-profile.html)的生成路径。

Procedure: 从项目分析中排除一个目录

如果您不希望 CLion 分析您项目的某个目录，请执行以下操作：

* 在   项目  工具窗口中，右键点击要排除的目录并选择  `将目录标记为 | 排除` ：

![将目录标记为已排除](https://resources.jetbrains.com/help/img/idea/2026.3/cl_mark_as_excluded.png)

代码生成、代码补全和重构将不适用于此目录。 除非您在   在文件中查找  对话框 `Ctrl+Shift+F` (Windows), `⌘ ⇧ F` (macOS), `⌃ ⇧ F` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ F` (macOS System Shortcuts), `Ctrl+Shift+F` (XWin), `Ctrl+Shift+F` (GNOME), `Ctrl+Shift+F` (KDE), `Ctrl+Shift+F` (Emacs), `Ctrl+Shift+F` (Sublime Text), `⌘ ⇧ F` (Sublime Text (macOS)), `⌘ ⇧ F` (Xcode), `Ctrl+Shift+F` (Visual Studio), `⌘ ⇧ F` (Visual Studio (macOS)), `Ctrl+Shift+F` (ReSharper), `⌘ ⇧ F` (ReSharper (macOS)), `Ctrl+Shift+F` (QtCreator), `⌘ ⇧ F` (QtCreator (macOS)), `Ctrl+Shift+F` (NetBeans), `Ctrl+H` (Eclipse), `⌃ H` (Eclipse (macOS))中 [显式选择此目录](finding-and-replacing-text-in-project.html#limit_search)，否则这些文件不会出现在搜索结果中。 该目录被标记为已排除 ![已排除目录图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.modules.excludeRoot.svg)。

要重新包含该目录，请右键点击它并选择  `标记目录为 | 取消排除` 。

> **Tip:**
> 如果您在远程开发模式下工作，您标记为已排除的目录将不会与远程机器同步。 请参阅 [Remote with local sources: excluded paths](remote-projects-support.html#excluded-paths)。

Procedure: 从项目分析中排除一个库

* 在   项目  工具窗口中，右键点击包含库文件的目录，然后选择  `标记目录为 | 库文件` ：

![标记为库文件](https://resources.jetbrains.com/help/img/idea/2026.3/cl_mark_as_library.png)

代码生成、代码补全和重构将不适用于此目录。 但是，您可以使这些文件在搜索结果中可用：

* 在 在文件中查找 对话框 `Ctrl+Shift+F` (Windows), `⌘ ⇧ F` (macOS), `⌃ ⇧ F` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ F` (macOS System Shortcuts), `Ctrl+Shift+F` (XWin), `Ctrl+Shift+F` (GNOME), `Ctrl+Shift+F` (KDE), `Ctrl+Shift+F` (Emacs), `Ctrl+Shift+F` (Sublime Text), `⌘ ⇧ F` (Sublime Text (macOS)), `⌘ ⇧ F` (Xcode), `Ctrl+Shift+F` (Visual Studio), `⌘ ⇧ F` (Visual Studio (macOS)), `Ctrl+Shift+F` (ReSharper), `⌘ ⇧ F` (ReSharper (macOS)), `Ctrl+Shift+F` (QtCreator), `⌘ ⇧ F` (QtCreator (macOS)), `Ctrl+Shift+F` (NetBeans), `Ctrl+H` (Eclipse), `⌃ H` (Eclipse (macOS))中：通过选择 项目和框架 作用域 [缩小搜索作用域](finding-and-replacing-text-in-project.html#limit_search)。

* 在 [全局搜索](searching-everywhere.html)时（按 `Shift` 两次）：检查 包含非项目项 或从窗口右上角的列表中选择 项目和框架 。

要取消标记该目录，请右键点击它并选择  `标记目录为 | 取消标记` 。

## See also

### 操作指南

[操作源代码](working-with-source-code.html)

