# 文件作用域与文件颜色

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

一个  作用域  ![作用域图标](https://resources.jetbrains.com/help/img/idea/2026.3/shared-scope.xml` ）。

如果您的 项目 受 [版本控制](version-control-integration.html)，那么使用共享作用域是有意义的。 如果您不使用 VCS，本地范围将足以满足您的需求。

> **Tip:**
> 此页面介绍如何为单个项目配置作用域和文件颜色。 如果您想为当前项目和所有新建项目（全局）配置这些设置，请在主菜单中转到  `文件 | 新建项目设置 | 新建项目设置` 。

## 定义一个新的作用域

在 CLion 中，有一组 [预定义作用域](#predefined-scopes-list)，但您也可以定义自己的作用域。

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. 请点击   添加作用域  按钮( ![添加作用域按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.add.svg))，然后选择您要定义的作用域类型： [local](#local-sc)或 [shared](#shared-sc)。

您可以稍后使用   通过 VCS 共享   复选框更改所选作用域（本地或共享）的状态。

![创建新作用域](https://resources.jetbrains.com/help/img/idea/2026.3/cl_scope_addoptions.png)

3. 在打开的对话框中，命名新作用域，然后点击   确定  。

4. 将文件添加到新作用域。 在 项目 树中选择必要的项目，然后点击树右侧的一个选项：

* 包含 ：包含所选项目。 如果您包含一个文件夹，此操作只会添加位于此文件夹内的文件。 所有嵌套的子文件夹及其内容将不会被包含。

* 递归包含 ：包含所选文件夹以及嵌套的子文件夹及其内容。

* 排除 ：将所选项目排除在作用域之外。 如果您排除了一个文件夹，此操作仅会删除位于该文件夹内的文件。 所有嵌套的子文件夹及其内容将保留在作用域内。

* 递归排除 ：排除所选文件夹及其嵌套子文件夹及其内容。

![添加了文件和文件夹的新作用域](https://resources.jetbrains.com/help/img/idea/2026.3/cl_scope_created.png)

当您将文件添加到作用域时，CLion 会创建一个表达式，并将其显示在   Pattern  字段中。

您也可以手动在   Pattern   字段中输入一个模式，使用 [作用域语言语法](scope-language-syntax-reference.html)参考。

5. 应用更改并关闭对话框。

为帮助您了解包含哪些内容而不包含哪些内容，所选作用域内显示的文件和文件夹以不同颜色显示：

* ![绿色示例](https://resources.jetbrains.com/help/img/idea/2026.3/green_square.png) 包含在作用域内的文件和文件夹。

* ![深蓝色样本](https://resources.jetbrains.com/help/img/idea/2026.3/blue_square.png) 包含已排除和已包含文件及文件夹的文件夹。

* ![黑色样本](https://resources.jetbrains.com/help/img/idea/2026.3/black_square.png) 从所选作用域中排除的文件和文件夹。

创建自定义作用域后，您可以在   项目   工具窗口以及允许您限制操作文件数量的 [所有对话框](#features)中找到它。

![检查代码对话框中的作用域](https://resources.jetbrains.com/help/img/idea/2026.3/cl_scope_inspectionsdialog.png)

## 预定义作用域

CLion 提供了一组预定义的作用域。 IDE 会根据文件的信息自动将文件添加到这些作用域。 请注意，这些作用域无法修改。

### 预定义作用域列表

* 项目文件 ：包含 项目 根目录中的所有文件。 如需了解更多信息，请参阅 [项目根目录](project.html#ProjectRootDirectory)。

* 所有更改的文件 ：包括所有最近更改的文件。

* 临时文件与控制台 ：包含 临时文件与控制台 目录中位于 项目 工具窗口中的所有文件。

* 最近查看的文件 和 最近更改的文件 ：包括您在编辑器中打开或修改的最后 50 个文件。 要更改最近文件的数量，请按 `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)) 打开设置并选择 高级设置 ，搜索 最近文件的最大数量 字段，然后指定首选的数量。

* 项目和库 ：包括 项目 内容根目录中的所有文件以及所有模块依赖项（库和 SDK）。

* 由 Git 跟踪的项目文件 ：包含 项目 内容根内在 Git 中受版本控制的所有文件。

* 排除 Git 忽略的项目文件 ：包含 项目 内容根内在 Git 中受版本控制和未版本控制的所有文件，但不包括 `.gitignore` 中指定的文件。

* 打开文件 ：包括编辑器中当前打开的文件。

* 本地更改 （如果 [启用 VCS 集成](enabling-version-control.html)，这些作用域将出现） * 所有更改的文件 ：包括尚未添加到 VCS 的所有更改列表中的已修改文件。 * 默认更改列表 ：包括尚未添加到 VCS 的 默认 变更列表中的修改文件。 * 'Changelist name' ：包括尚未添加到 VCS 的特定自定义更改列表中的已修改文件。

* 数据源 * 上下文数据源 ：包含您当前正在使用的数据源。 上下文可以通过您正在使用的控制台、数据编辑器或在数据库资源管理器中选择来定义。 * 已连接的数据源 ：包含具有活动连接的数据源。 * 所有数据源 ：包含所有已添加的数据源。

## 将作用域与颜色关联

属于不同作用域的文件可以在搜索结果、编辑器选项卡和   项目  工具窗口（ `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/fileColors.xml` ）。

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. 请确保选中   启用文件颜色  复选框，然后选择您要使用颜色的位置：选择   在编辑器标签页中使用  或   在项目视图中使用  。

如果选中   在项目视图中使用  复选框，您将在   项目  工具窗口（ `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))）和搜索结果中看到颜色（例如，在   在文件中查找  对话框 `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))中）。

3. 点击   Add  按钮( !["添加"图标](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.add.svg))，然后选择要配置颜色的作用域。

您可以选择一个预定义作用域或使用一个 [custom scope](#creating-a-new-custom-scope)。

4. 点击必要作用域旁边的箭头 ![右箭头图标](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.chevronRight.svg)，然后从打开的列表中选择一种颜色。

要配置您自己的颜色，请点击   自定义  。

![为自定义作用域选择颜色](https://resources.jetbrains.com/help/img/idea/2026.3/cl_filecolors_pickcolor.png)

5. 要编辑颜色，请点击   颜色   列中对应于所需作用域的单元格，然后从列表中选择一个新颜色。

6. 要通过 VCS [共享](#shared-clrs) 颜色，请在   通过 VCS 共享   列的相应行中选中复选框。 如果取消选中复选框，颜色将被 [本地](#local-clrs)使用。

7. 应用更改并关闭对话框。

如果一个文件包含在多个作用域内，作用域的顺序就变得很重要：CLion 从顶部到底部依次处理作用域，从本地作用域开始。 这意味着 IDE 会将列表中最后一个作用域的颜色应用于这样的文件。

您可以更改作用作用域的顺序，以便 CLion 按不同的顺序处理颜色关联。

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. 请选择需要移动的作用域，然后点击   上移   ( !["向上移动"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.moveUp.svg)) 或   下移   ( !["向下移动"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.moveDown.svg)) 按钮。 或者，按 `Alt+Up` (Windows), `⌥ ↑` (macOS), `⌥ ↑` (IntelliJ IDEA Classic (macOS)), `⌥ ↑` (macOS System Shortcuts), `Alt+Up` (XWin), `Alt+Up` (GNOME), `Alt+Up` (KDE), `Alt+Up` (Emacs), `Alt+Up` (Sublime Text), `⌥ ↑` (Sublime Text (macOS)), `⌥ ↑` (Xcode), `Alt+Up` (Visual Studio), `⌥ ↑` (Visual Studio (macOS)), `Alt+Up` (ReSharper), `⌥ ↑` (ReSharper (macOS)), `Alt+Up` (QtCreator), `⌥ ↑` (QtCreator (macOS)), `Alt+Up` (NetBeans), `Alt+Up` (Eclipse), `⌥ ↑` (Eclipse (macOS)) 或 `Alt+Down` (Windows), `⌥ ↓` (macOS), `⌥ ↓` (IntelliJ IDEA Classic (macOS)), `⌥ ↓` (macOS System Shortcuts), `Alt+Down` (XWin), `Alt+Down` (GNOME), `Alt+Down` (KDE), `Alt+Down` (Emacs), `Alt+Down` (Sublime Text), `⌥ ↓` (Sublime Text (macOS)), `⌥ ↓` (Xcode), `Alt+Down` (Visual Studio), `⌥ ↓` (Visual Studio (macOS)), `Alt+Down` (ReSharper), `⌥ ↓` (ReSharper (macOS)), `Alt+Down` (QtCreator), `⌥ ↓` (QtCreator (macOS)), `Alt+Down` (NetBeans), `Alt+Down` (Eclipse), `⌥ ↓` (Eclipse (macOS))。

3. 应用更改并关闭对话框。

## See also

### 流程

### 参考

