# 项目工具窗口

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

> **TL;DR**
> `视图 | 工具窗口 | 项目`  或 `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))

项目   工具窗口（ `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))）可让您从各种视角查看 [项目](project.html)，并执行不同任务，例如创建新项（目录、文件、类等）、在编辑器中打开文件、导航到所需的代码段等。

默认情况下，项目工具窗口会显示当前 [项目根目录](project.html#ProjectRootDirectory)。

![项目工具窗口](https://resources.jetbrains.com/help/img/idea/2026.3/cl_project_tool_window.png)

此工具窗口中的大多数功能可以通过内容窗格中的上下文菜单命令和相关快捷键访问。

![项目工具窗口上下文菜单](https://resources.jetbrains.com/help/img/idea/2026.3/cl_prjtw_contextmenu.png)

此外，该视图包含   临时文件与控制台   文件夹，可用于管理创建的临时文件和扩展程序脚本。

![临时文件与控制台](https://resources.jetbrains.com/help/img/idea/2026.3/cl_scratch_files_location.png)

## 视图

您可以使用项目工具窗口查看项目树或某个文件作用域：

![项目视图中的文件作用域](https://resources.jetbrains.com/help/img/idea/2026.3/cl_scopes_projectview.png)

* 项目 视图。 该视图显示所有 项目 项目及其依赖项（SDK 和库）。

* 作用域视图（ 项目文件 、 打开文件 等）。 这些视图显示了预定义和用户定义的 [scopes](configuring-scopes-and-file-colors.html)的内容。

视图元素会根据 [文件颜色对话框](settings-file-colors.html) 中定义的作用域-颜色关联以及与作用域关联的叠加图标进行高亮显示。

> **Tip:**
> 要在视图之间快速切换，请按 `Alt+Right` (Windows), `⌘ ⇧ ]` (macOS), `⌃ →` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ →` (macOS System Shortcuts), `Alt+Right` (XWin), `Alt+Right` (GNOME), `Alt+Right` (KDE), `Alt+Right` (Emacs), `Ctrl+Page Down` (Sublime Text), `⌘ ⇧ ]` (Sublime Text (macOS)), `⌘ ⇧ ]` (Xcode), `Alt+Right` (Visual Studio), `⌘ ⇧ ]` (Visual Studio (macOS)), `Alt+Right` (ReSharper), `⌘ ⇧ ]` (ReSharper (macOS)), `Alt+Right` (QtCreator), `Alt+Right` (QtCreator (macOS)), `Ctrl+Page Down` (NetBeans), `Ctrl+F6` (Eclipse), `⌘ F6` (Eclipse (macOS))/ `Alt+Left` (Windows), `⌘ ⇧ [` (macOS), `⌃ ←` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ ←` (macOS System Shortcuts), `Alt+Left` (XWin), `Alt+Left` (GNOME), `Alt+Left` (KDE), `Alt+Left` (Emacs), `Ctrl+Page Up` (Sublime Text), `⌘ ⇧ [` (Sublime Text (macOS)), `⌘ ⇧ [` (Xcode), `Alt+Left` (Visual Studio), `⌘ ⇧ [` (Visual Studio (macOS)), `Alt+Left` (ReSharper), `⌘ ⇧ [` (ReSharper (macOS)), `Alt+Left` (QtCreator), `Alt+Left` (QtCreator (macOS)), `Ctrl+Page Up` (NetBeans), `Ctrl+Shift+F6` (Eclipse), `⌘ ⇧ F6` (Eclipse (macOS))

您还可以在单独的选项卡中显示每个视图：点击 ![设置](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.moreVertical.svg) 并禁用   分组选项卡   选项。

## 外观和行为

Procedure: 快速添加文件和文件夹

可以从工具窗口工具栏创建新文件或文件夹。 可用选项取决于工具窗口中选定的节点。

* 点击工具窗口工具栏上的 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.add.svg)，然后从列表中选择一个选项。

使用 [快速搜索](speed-search-in-the-tool-windows.html)更快地查找选项：开始键入要创建的文件类型以缩小结果范围。

Procedure: 预览文件

有两种方法无需在单独的选项卡中打开文件即可预览：

* 使用文件预览弹出窗口：在   项目   工具窗口（ `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))）中选择一个文件，然后按  `空格` 。

![在 Project 工具窗口中打开文件预览](https://resources.jetbrains.com/help/img/idea/2026.3/cl_projectview_preview.png)

* 启用 [预览选项卡](using-code-editor.html#preview-tab)：点击 ![“选项”按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.moreVertical.svg) 并选择  `行为 | 启用预览选项卡` 。

Procedure: 显示文件大小和修改时间

您可以查看 项目 树中文件的大小和修改时间戳。

* 在   项目   工具窗口（ `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))）中，点击 ![“选项”按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.moreVertical.svg) 并选择  `外观 | 文件详细信息` 。

![项目视图中的详细信息](https://resources.jetbrains.com/help/img/idea/2026.3/cl_projectview_descriptions.png)

Procedure: 显示树缩进指南

在   项目   工具窗口中，可以显示用于标记缩进级别的垂直线，帮助更好地了解 项目 中组件的层次结构。

1. 按下 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `外观与行为 | 外观` 。

2. 在   树视图   部分，启用   显示缩进指示线   选项。

Procedure: 点击一次即可打开文件

可以将   项目   工具窗口配置为点击一次即可在编辑器中打开文件。

* 在   项目   工具窗口中，点击 ![“选项”按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.moreVertical.svg) 并启用  `行为 | 单击打开文件`  选项。

Procedure: 在项目工具窗口中快速定位文件

CLion 可以通过在   项目   工具窗口中自动选中当前在活动编辑器选项卡中打开的文件，帮助跟踪该文件。

* 在   项目   工具窗口中，点击 ![“选项”按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.moreVertical.svg) 并启用  `行为 | 始终选择已打开的文件`  选项。

![项目视图上下文菜单](https://resources.jetbrains.com/help/img/idea/2026.3/cl_prjview_contextmenu.png)

## 标题上下文菜单

通过右键点击标题或点击   选项  按钮 ![选项图标](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.moreVertical.svg)出现的上下文菜单提供项目 [视图](#views)的设置。

下表列出了可用的命令和选项，并进行了简要说明。

|  项  |  快捷方式  |  描述  |
| --- | --- | --- |
|    行为    |  |
|    启用预览选项卡    |  |  启用 [预览选项卡](using-code-editor.html#preview-tab)，可在单个选项卡中逐个查看文件，而无需在新选项卡中打开每个文件。  |
|    点击打开文件    |  |     在   项目   工具窗口中点击某个项一次，即可在编辑器中打开该项。 否则，您需要双击项目才能打开它们。       请注意，如果启用了 [预览选项卡](using-code-editor.html#preview-tab)，则无法禁用此选项。     |
|    单击一次打开目录    |  |  在   项目   工具窗口中点击目录一次，即可展开和收起目录。 否则，您需要双击目录以将其打开，或者使用目录名称旁边的 ![展开](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.arrowExpand.svg)图标。  |
|    始终选择已打开的文件    |  |  如果此选项开启，CLion 将自动定位您在编辑器中打开的文档到此窗口的当前视图中。  |
|    外观    |  |
|    临时文件与控制台    |  |     隐藏或显示   临时文件与控制台  节点。       此节点包含您的 [临时文件](scratches.html) 和 [查询控制台](query-consoles.html)。     |
|    文件详情    |  |     选择此选项以显示文件的大小和修改时间戳。     |
|    自定义树视图    |  |  请导航至  `设置 \| 外观与行为 \| 外观 \| 树视图`  配置 [树视图选项](settings-appearance.html#tree-views)。  |
|    排序方式    |  |
|    名称    |  |     按文件名称字母顺序排序。       此选项不会影响文件夹的顺序，文件夹始终按字母顺序排序。     |
|    Type    |  |     按文件扩展名排序。       此选项不会影响文件夹的顺序，文件夹始终按字母顺序排序。     |
|    修改时间（最新优先/最旧优先）    |  |     按文件修改时间排序。 要显示此信息，请从主菜单中选择  `视图 \| 外观 \| 树状视图中的详细信息` 。       此选项不会影响文件夹的顺序，文件夹始终按字母顺序排序。     |
|    文件夹始终置顶    |  |  如果该选项开启，文件夹将显示在文件上方。 否则，所有项目按字母顺序排序，文件和文件夹会混在一起显示。  |
|    快速搜索    |  `Ctrl+F` (Windows), `⌘ F` (macOS), `⌘ F` (IntelliJ IDEA Classic (macOS)), `⌘ F` (macOS System Shortcuts), `Ctrl+F` (XWin), `Ctrl+F` (GNOME), `Ctrl+F` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+F` (Sublime Text), `⌘ F` (Sublime Text (macOS)), `⌘ F` (Xcode), `Ctrl+F` (Visual Studio), `⌘ F` (Visual Studio (macOS)), `Ctrl+F` (ReSharper), `⌘ F` (ReSharper (macOS)), `Ctrl+F` (QtCreator), `⌘ F` (QtCreator (macOS)), `Ctrl+F` (NetBeans), `Ctrl+F` (Eclipse), `Ctrl+F` (Eclipse (macOS))  |  搜索项目。 了解更多 [工具窗口中的 Speed Search](speed-search-in-the-tool-windows.html)  |
|    查看模式    |  |  此选项可控制工具窗口的一般外观和行为。 有关完整信息，请参阅 [查看模式](viewing-modes.html)。  |
|    移动到    |  |  要将工具窗口关联到其他 [工具窗口栏](tool-windows.html#bars_and_buttons)，请选择此命令，然后选择目标工具窗口栏（   顶部  、   左  、   底部   或   右  ）。 有关完整信息，请参阅 [移动工具窗口](manipulating-the-tool-windows.html#move-tool-windows) 章节。  |
|    调整大小    |  |     要通过移动工具窗口的某个边框来调整其大小，请选择此命令，然后选择所需的   延展至   选项。       请注意，此命令不适用于浮动模式。     |
|    从侧边栏移除    |  |     此命令会隐藏工具窗口，从工具窗口栏中移除关联的 [工具窗口按钮](tool-windows.html#bars_and_buttons)，并从 [快速访问菜单](null)（ ![tb shown](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.tbShown.svg) 或 ![tb hidden](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.tbHidden.svg)）中移除工具窗口。       要重新打开工具窗口（并恢复相关功能），请使用主菜单：  `视图 \| 工具窗口 \| <Window Name>` 或按 `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))。     |
|    隐藏    |  `Shift+Escape` (Windows), `⇧ ⎋` (macOS), `⇧ ⎋` (IntelliJ IDEA Classic (macOS)), `⇧ ⎋` (macOS System Shortcuts), `Shift+Escape` (XWin), `Shift+Escape` (GNOME), `Shift+Escape` (KDE), `Shift+Escape` (Emacs), `Shift+Escape` (Sublime Text), `⇧ ⎋` (Sublime Text (macOS)), `⇧ ⎋` (Xcode), `Shift+Escape` (Visual Studio), `⇧ ⎋` (Visual Studio (macOS)), `Shift+Escape` (ReSharper), `⇧ ⎋` (ReSharper (macOS)), `Shift+Escape` (QtCreator), `⇧ ⎋` (QtCreator (macOS)), `Shift+Escape` (NetBeans), `Shift+Escape` (Eclipse), `⇧ ⎋` (Eclipse (macOS))  |  隐藏工具窗口。  |
|    帮助    |  |  此命令会在 CLion 在线帮助中打开   项目   工具窗口的描述。  |

## 内容窗格

内容窗格显示 项目 项目项，例如目录、文件和其他元素。

标有蓝色叠加徽章 ![源工具文件层](https://resources.jetbrains.com/help/img/idea/2026.3/app.modules.sourceRootFileLayer.svg) 的文件是源文件（对于 [CMake](quick-cmake-tutorial.html) 项目，如果文件图标没有此叠加徽章，则表示该文件未包含在  `CMakeLists.txt`  中）。

|  项  |  描述  |
| --- | --- |
|  ![文件夹](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.nodes.folder.svg)  |     一个文件夹（目录）。 不同的文件夹类别有不同的颜色。        * 目录 ![普通文件夹](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.nodes.folder.svg)    * 排除的文件夹 ![排除的文件夹](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.nodes.excludeRoot.svg)    |
|  ![库](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.nodes.libraryFolder.svg)  |    外部库  ，用于对与 项目 关联的第三方软件进行分组的类别。 仅在选择   项目   视图时显示该节点。  |
|  ![临时文件与控制台](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.fileTypes.scratches.svg)  |  [临时文件](scratches.html)和控制台会分组在此节点下。  |

## 文件状态高亮

如果当前 项目 [启用了 VCS 集成](enabling-version-control.html)，CLion 会使用颜色标注 VCS 文件状态在   项目   工具窗口中。

您可以在   版本控制 | 文件状态颜色  设置页面 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))上配置 VCS 文件状态颜色。

> **Tip:**
> 要同时高亮显示包含已修改内容的文件夹，请在   版本控制 | 确认  设置页面 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))上选择   在项目树中高亮显示包含已修改文件的目录  。

下表列出了在部分 [配色方案](configuring-colors-and-fonts.html)中的默认文件状态颜色及其含义。

浅色主题:

|  颜色  |  文件状态  |  描述  |
| --- | --- | --- |
|  ![颜色样本：深绿色](https://resources.jetbrains.com/help/img/idea/2026.3/added-light.png)  #0A7700   |  已添加  |  处于活动 [changelist](managing-changelists.html) 中的文件已计划添加到存储库。  |
|  ![颜色示例：green](https://resources.jetbrains.com/help/img/idea/2026.3/added-inactive-changelist-light.png)  #0EAA00   |  在非活动更改列表中添加  |  该文件在未激活的变更列表中已安排添加到存储库。 若在   突出显示未激活变更列表中的文件  选项中启用了  `设置 \| 版本控制 \| Changelists` ，则文件状态可用。  |
|  ![颜色示例：red](https://resources.jetbrains.com/help/img/idea/2026.3/conflicts-light.png)  #FF0000   |  更改列表冲突  |  在非活动更改列表中的文件已在活动更改列表中被修改。 在这种情况下，将会打开一个新的对话框，提示您解决 [changelist conflict](resolve-conflicts.html)。 如果在  `设置 \| 版本控制 \| Changelists`  中启用所有选项，则此文件状态可用。  |
|  ![颜色样本：深绿色](https://resources.jetbrains.com/help/img/idea/2026.3/added-light.png)  #0A7700   |  已复制  |  如果文件是另一文件的副本，则会跟踪其元数据，并将此类文件标记为   已复制  。  |
|  ![颜色示例：灰色](https://resources.jetbrains.com/help/img/idea/2026.3/deleted-light.png)  #616161   |  已删除  |  该文件已被安排从存储库中删除。  |
|  ![颜色示例：灰紫色](https://resources.jetbrains.com/help/img/idea/2026.3/deleted-from-filesystem-light.png)  #773895   |  从文件系统中删除  |  该文件已在本地删除，但尚未被安排删除，仍然存在于存储库中。  |
|  ![颜色样本：浅灰蓝色](https://resources.jetbrains.com/help/img/idea/2026.3/changed-descendants-light.png)  #8AA4C8   |  有更改的后代项  |  如果文件被修改，IDE 将递归高亮包含该文件的所有目录。 如果在   在项目树中高亮显示包含已修改文件的目录  中启用了  `设置 \| 版本控制 \| 确认` 选项，则此状态可用。  |
|  ![颜色样本：亮蓝](https://resources.jetbrains.com/help/img/idea/2026.3/changed-children-light.png)  #3264B4   |  有直接更改的子项  |  如果文件被修改，IDE 会高亮显示其父目录。 如果在   在项目树中高亮显示包含已修改文件的目录  中启用了  `设置 \| 版本控制 \| 确认` 选项，则此状态可用。  |
|  ![颜色样本：light brown](https://resources.jetbrains.com/help/img/idea/2026.3/hijacked-light.png)  #B28C00   |  被劫持  |  [Perforce，ClearCase，VSS] 文件 [未签出已被修改。](handling-modified-without-checkout-files.html)  |
|  ![颜色样本：深橄榄绿](https://resources.jetbrains.com/help/img/idea/2026.3/ignored-light.png)  #727238   |  已忽略  |  文件被故意排除在 VCS 跟踪之外。  |
|  ![颜色样本：purple](https://resources.jetbrains.com/help/img/idea/2026.3/merged-light.png)  #7503DC   |  已合并  |  “文件已被您的 VCS 因更新而合并。”  |
|  ![颜色示例：red](https://resources.jetbrains.com/help/img/idea/2026.3/conflicts-light.png)  #FF0000   |  合并时有冲突  |  在上次更新期间，文件已合并并存在冲突。  |
|  ![颜色示例：red](https://resources.jetbrains.com/help/img/idea/2026.3/conflicts-light.png)  #FF0000   |  与属性冲突合并  |  在上次更新期间，IDE 检测到本地文件与其服务器版本的属性之间存在差异。  |
|  ![颜色示例：red](https://resources.jetbrains.com/help/img/idea/2026.3/conflicts-light.png)  #FF0000   |  合并时有文本和属性冲突  |  当两位或更多开发者修改同一文件的相同行和同一文件属性时，会发生文本和属性冲突。  |
|  ![颜色样本：亮海军蓝](https://resources.jetbrains.com/help/img/idea/2026.3/modified-light.png)  ＃0032A0   |  已修改  |  该文件自上次同步以来已更改。  |
|  ![颜色样本：蓝色](https://resources.jetbrains.com/help/img/idea/2026.3/modified-inactive-changelist-light.png)  #0047E4   |  在非活动更改列表中修改  |  已修改的文件处于非活动变更列表中。 若在   突出显示未激活变更列表中的文件  选项中启用了  `设置 \| 版本控制 \| Changelists` ，则文件状态可用。  |
|  ![颜色样本：Olive](https://resources.jetbrains.com/help/img/idea/2026.3/obsolete-light.png)  #7C7C00   |  已废弃  |  该文件不应再位于您的仓库工作副本中。  |
|  ![颜色样本：teal](https://resources.jetbrains.com/help/img/idea/2026.3/renamed-light.png)  #007C7C   |  已重命名  |  自上次更新以来，文件已被重命名。  |
|  ![颜色样本：深青色](https://resources.jetbrains.com/help/img/idea/2026.3/switched-light.png)  #08978F   |  已切换  |  [SVN] 文件来自与整个项目不同的分支。  |
|  ![颜色样本：褐色](https://resources.jetbrains.com/help/img/idea/2026.3/unversioned-light.png)  #993300   |  (未知) 无版本  |  该文件在本地存在，但不在代码库中，也未被安排添加。  |
|  ![颜色样本：黑色](https://resources.jetbrains.com/help/img/idea/2026.3/up-to-date-light.png) 无 (默认颜色)  |  最新  |  该文件未被更改。  |

Darcula 主题:

|  颜色  |  文件状态  |  描述  |
| --- | --- | --- |
|  ![颜色样本：暗绿色](https://resources.jetbrains.com/help/img/idea/2026.3/added-darcula.png)  #629755   |  已添加  |  处于活动 [changelist](managing-changelists.html) 中的文件已计划添加到存储库。  |
|  ![颜色样本：暗绿色](https://resources.jetbrains.com/help/img/idea/2026.3/added-darcula.png)  #629755   |  在非活动更改列表中添加  |  该文件在未激活的变更列表中已安排添加到存储库。 若在   突出显示未激活变更列表中的文件  选项中启用了  `设置 \| 版本控制 \| Changelists` ，则文件状态可用。  |
|  ![颜色示例：暗红色](https://resources.jetbrains.com/help/img/idea/2026.3/conflicts-darcula.png)  # D5756C   |  更改列表冲突  |  在非活动更改列表中的文件已在活动更改列表中被修改。 在这种情况下，将会打开一个新的对话框，提示您解决 [changelist conflict](resolve-conflicts.html)。 如果在  `设置 \| 版本控制 \| Changelists`  中启用所有选项，则此文件状态可用。  |
|  ![颜色示例：green](https://resources.jetbrains.com/help/img/idea/2026.3/copied-darcula.png)  #0A7700   |  已复制  |  如果文件是另一文件的副本，则会跟踪其元数据，并将此类文件标记为   已复制  。  |
|  ![颜色示例：灰色](https://resources.jetbrains.com/help/img/idea/2026.3/deleted-darcula.png)  #6C6C6C   |  已删除  |  该文件已被安排从存储库中删除。  |
|  ![颜色示例：灰紫色](https://resources.jetbrains.com/help/img/idea/2026.3/deleted-darcula.png)  #6C6C6C   |  从文件系统中删除  |  该文件已在本地删除，但尚未被安排删除，仍然存在于存储库中。  |
|  ![颜色示例：淡蓝色](https://resources.jetbrains.com/help/img/idea/2026.3/changed-descendants-darcula.png)  #6897BB   |  有更改的后代项  |  如果文件被修改，IDE 将递归高亮包含该文件的所有目录。 如果在   在项目树中高亮显示包含已修改文件的目录  中启用了  `设置 \| 版本控制 \| 确认` 选项，则此状态可用。  |
|  ![颜色示例：淡蓝色](https://resources.jetbrains.com/help/img/idea/2026.3/changed-descendants-darcula.png)  #6897BB   |  有直接更改的子项  |  如果文件被修改，IDE 会高亮显示其父目录。 如果在   在项目树中高亮显示包含已修改文件的目录  中启用了  `设置 \| 版本控制 \| 确认` 选项，则此状态可用。  |
|  ![颜色样例：白色](https://resources.jetbrains.com/help/img/idea/2026.3/hijacked-darcula.png) 无 (默认颜色)  |  被劫持  |  [Perforce，ClearCase，VSS] 文件 [未签出已被修改。](handling-modified-without-checkout-files.html)  |
|  ![色样：浅橄榄色](https://resources.jetbrains.com/help/img/idea/2026.3/ignored-darcula.png)  #848504   |  已忽略  |  文件被故意排除在 VCS 跟踪之外。  |
|  ![颜色样本：浅紫色](https://resources.jetbrains.com/help/img/idea/2026.3/merged-darcula.png)  #9876AA   |  已合并  |  “文件已被您的 VCS 因更新而合并。”  |
|  ![颜色示例：暗红色](https://resources.jetbrains.com/help/img/idea/2026.3/conflicts-darcula.png)  # D5756C   |  合并时有冲突  |  在上次更新期间，文件已合并并存在冲突。  |
|  ![颜色示例：暗红色](https://resources.jetbrains.com/help/img/idea/2026.3/conflicts-darcula.png)  # D5756C   |  与属性冲突合并  |  在上次更新期间，IDE 检测到本地文件与其服务器版本的属性之间存在差异。  |
|  ![颜色示例：暗红色](https://resources.jetbrains.com/help/img/idea/2026.3/conflicts-darcula.png)  # D5756C   |  合并时有文本和属性冲突  |  当两位或更多开发者修改同一文件的相同行和同一文件属性时，会发生文本和属性冲突。  |
|  ![颜色示例：淡蓝色](https://resources.jetbrains.com/help/img/idea/2026.3/changed-descendants-darcula.png)  #6897BB   |  已修改  |  该文件自上次同步以来已更改。  |
|  ![颜色示例：淡蓝色](https://resources.jetbrains.com/help/img/idea/2026.3/changed-descendants-darcula.png)  #6897BB   |  在非活动更改列表中修改  |  已修改的文件处于非活动变更列表中。 若在   突出显示未激活变更列表中的文件  选项中启用了  `设置 \| 版本控制 \| Changelists` ，则文件状态可用。  |
|  ![颜色样例：白色](https://resources.jetbrains.com/help/img/idea/2026.3/hijacked-darcula.png) 无 (默认颜色)  |  已废弃  |  该文件不应再位于您的仓库工作副本中。  |
|  ![颜色样本：强青色](https://resources.jetbrains.com/help/img/idea/2026.3/renamed-darcula.png)  #3A8484   |  已重命名  |  自上次更新以来，文件已被重命名。  |
|  ![颜色样例：白色](https://resources.jetbrains.com/help/img/idea/2026.3/hijacked-darcula.png) 无 (默认颜色)  |  已切换  |  [SVN] 文件来自与整个项目不同的分支。  |
|  ![颜色样本：浅红色](https://resources.jetbrains.com/help/img/idea/2026.3/unversioned-darcula.png)  #D1675A   |  (未知) 无版本  |  该文件在本地存在，但不在代码库中，也未被安排添加。  |
|  ![颜色样例：白色](https://resources.jetbrains.com/help/img/idea/2026.3/hijacked-darcula.png) 无 (默认颜色)  |  最新  |  该文件未被更改。  |

高对比度主题:

|  颜色  |  文件状态  |  描述  |
| --- | --- | --- |
|  ![颜色示例：green](https://resources.jetbrains.com/help/img/idea/2026.3/added-hcontrast.png)  #62CC47   |  已添加  |  处于活动 [changelist](managing-changelists.html) 中的文件已计划添加到存储库。  |
|  ![颜色示例：green](https://resources.jetbrains.com/help/img/idea/2026.3/added-hcontrast.png)  #62CC47   |  在非活动更改列表中添加  |  该文件在未激活的变更列表中已安排添加到存储库。 若在   突出显示未激活变更列表中的文件  选项中启用了  `设置 \| 版本控制 \| Changelists` ，则文件状态可用。  |
|  ![颜色示例：暗红色](https://resources.jetbrains.com/help/img/idea/2026.3/conflicts-hcontrast.png)  #FF6666   |  更改列表冲突  |  在非活动更改列表中的文件已在活动更改列表中被修改。 在这种情况下，将会打开一个新的对话框，提示您解决 [changelist conflict](resolve-conflicts.html)。 如果在  `设置 \| 版本控制 \| Changelists`  中启用所有选项，则此文件状态可用。  |
|  ![颜色示例：green](https://resources.jetbrains.com/help/img/idea/2026.3/added-hcontrast.png)  #62CC47   |  已复制  |  如果文件是另一文件的副本，则会跟踪其元数据，并将此类文件标记为   已复制  。  |
|  ![颜色样本：橙色](https://resources.jetbrains.com/help/img/idea/2026.3/deleted-hcontrast.png)  #ED864A   |  已删除  |  该文件已被安排从存储库中删除。  |
|  ![颜色样本：橙色](https://resources.jetbrains.com/help/img/idea/2026.3/deleted-hcontrast.png)  #ED864A   |  从文件系统中删除  |  该文件已在本地删除，但尚未被安排删除，仍然存在于存储库中。  |
|  ![颜色样本：鲜艳的青色](https://resources.jetbrains.com/help/img/idea/2026.3/changed-descendants-hcontrast.png)  #4FF0FF   |  有更改的后代项  |  如果文件被修改，IDE 将递归高亮包含该文件的所有目录。 如果在   在项目树中高亮显示包含已修改文件的目录  中启用了  `设置 \| 版本控制 \| 确认` 选项，则此状态可用。  |
|  ![颜色样本：鲜艳的青色](https://resources.jetbrains.com/help/img/idea/2026.3/changed-descendants-hcontrast.png)  #4FF0FF   |  有直接更改的子项  |  如果文件被修改，IDE 会高亮显示其父目录。 如果在   在项目树中高亮显示包含已修改文件的目录  中启用了  `设置 \| 版本控制 \| 确认` 选项，则此状态可用。  |
|  ![颜色样例：白色](https://resources.jetbrains.com/help/img/idea/2026.3/hijacked-darcula.png) 无 (默认颜色)  |  被劫持  |  [Perforce，ClearCase，VSS] 文件 [未签出已被修改。](handling-modified-without-checkout-files.html)  |
|  ![色样：浅橄榄色](https://resources.jetbrains.com/help/img/idea/2026.3/ignored-hcontrast.png)  #A9B837   |  已忽略  |  文件被故意排除在 VCS 跟踪之外。  |
|  ![颜色样本：浅紫色](https://resources.jetbrains.com/help/img/idea/2026.3/merged-hcontrast.png)  #ED94FF   |  已合并  |  “文件已被您的 VCS 因更新而合并。”  |
|  ![颜色示例：暗红色](https://resources.jetbrains.com/help/img/idea/2026.3/conflicts-hcontrast.png)  #FF6666   |  合并时有冲突  |  在上次更新期间，文件已合并并存在冲突。  |
|  ![颜色示例：暗红色](https://resources.jetbrains.com/help/img/idea/2026.3/conflicts-hcontrast.png)  #FF6666   |  与属性冲突合并  |  在上次更新期间，IDE 检测到本地文件与其服务器版本的属性之间存在差异。  |
|  ![颜色示例：暗红色](https://resources.jetbrains.com/help/img/idea/2026.3/conflicts-hcontrast.png)  #FF6666   |  合并时有文本和属性冲突  |  当两位或更多开发者修改同一文件的相同行和同一文件属性时，会发生文本和属性冲突。  |
|  ![颜色样本：鲜艳的青色](https://resources.jetbrains.com/help/img/idea/2026.3/changed-descendants-hcontrast.png)  #4FF0FF   |  已修改  |  该文件自上次同步以来已更改。  |
|  ![颜色样本：鲜艳的青色](https://resources.jetbrains.com/help/img/idea/2026.3/changed-descendants-hcontrast.png)  #4FF0FF   |  在非活动更改列表中修改  |  已修改的文件处于非活动变更列表中。 若在   突出显示未激活变更列表中的文件  选项中启用了  `设置 \| 版本控制 \| Changelists` ，则文件状态可用。  |
|  ![颜色样例：白色](https://resources.jetbrains.com/help/img/idea/2026.3/hijacked-darcula.png) 无 (默认颜色)  |  已废弃  |  该文件不应再位于您的仓库工作副本中。  |
|  ![颜色样本：鲜艳的青色](https://resources.jetbrains.com/help/img/idea/2026.3/changed-descendants-hcontrast.png)  #4FF0FF   |  已重命名  |  自上次更新以来，文件已被重命名。  |
|  ![颜色样例：白色](https://resources.jetbrains.com/help/img/idea/2026.3/hijacked-darcula.png) 无 (默认颜色)  |  已切换  |  [SVN] 文件来自与整个项目不同的分支。  |
|  ![颜色样本：浅红色](https://resources.jetbrains.com/help/img/idea/2026.3/unversioned-darcula.png)  D1675A   |  (未知) 无版本  |  该文件在本地存在，但不在代码库中，也未被安排添加。  |
|  ![颜色样例：白色](https://resources.jetbrains.com/help/img/idea/2026.3/hijacked-darcula.png) 无 (默认颜色)  |  最新  |  该文件未被更改。  |

## 文件颜色

属于不同作用域的文件（例如生产文件或测试文件）可以在   项目   工具窗口、搜索结果和编辑器选项卡中以不同颜色高亮显示。

对每个作用域，您可以分配其自己的颜色。 欲了解更多信息，请参阅 [将作用域与颜色关联](configuring-scopes-and-file-colors.html#associate-file-color-with-a-scope)。

![项目视图中的作用域高亮](https://resources.jetbrains.com/help/img/idea/2026.3/cl_scope_highlighting.png)

## See also

### 快速开始

[工具窗口](tool-windows.html)

