# 文件范围与文件颜色

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

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

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

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

## 定义新范围

在 IntelliJ IDEA 中，有一组 [预定义作用域](#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)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `外观 & 行为 | 作用域` 。

2. 点击   添加作用域   按钮（ ![添加范围按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.general.add.svg)），然后选择要定义的作用域类型： [本地](#local-sc) 或 [共享](#shared-sc)。

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

![创建新作用域：选择共享作用域还是本地作用域](https://resources.jetbrains.com.cn/help/img/idea/2026.3/scopes-local-shared.png)

3. 在打开的对话框中，为新作用域指定名称，然后点击   OK  。

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

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

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

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

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

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

向作用域添加文件时，IntelliJ IDEA 会创建一个表达式并将其显示在   模式   字段中。

除了使用按钮，您还可以在   模式  字段中手动输入模式，使用 [范围语言语法](scope-language-syntax-reference.html)参考。

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

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

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

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

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

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

![项目工具窗口中显示的新范围](https://resources.jetbrains.com.cn/help/img/idea/2026.3/scope-project-tw.png)

## 预定义作用域

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

### 预定义范围列表

* 项目文件 ：包括 project 内容根目录中的所有文件。 更多信息请参阅 [内容根](content-roots.html)。 库和 SDK 不包含在此范围内。

* 问题 ：包含 project 内容根目录中的语法错误文件。

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

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

* 最近查看的文件 和 最近更改的文件 ：包括您在编辑器中打开或修改的最后 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)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置并选择 高级设置 ，搜索 最近文件的最大数量 字段，然后指定首选的数量。

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

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

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

* 项目生产文件 ：包括 project 内容根目录内的所有文件，测试源目录除外。 在 项目 工具窗口（ `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)), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (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)), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS))）中，此作用域对应于 测试 视图。

* 非项目文件 ：此范围仅可在 项目 工具窗口中作为视图使用。 它包括库和 SDK。

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

* 当前文件 ：对应当前在编辑器中活动的文件。

* 选定文件 ：包含在工具窗口中选定的文件（例如，在 项目 工具窗口（ `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)), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS))）中）。

* 类层次结构 ：包括与所选类相互关联的类。 在选择此范围后，系统将提示您选择层次结构的基类。

* 本地更改 （如果 [已启用 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)), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS))）中以不同颜色高亮显示。

![在编辑器选项卡和搜索结果中的范围高亮显示](https://resources.jetbrains.com.cn/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)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (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)), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (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)), `Ctrl+Shift+F` (Visual Studio), `⌘ ⇧ F` (Visual Studio (macOS)), `Ctrl+Shift+F` (NetBeans), `Ctrl+H` (Eclipse), `⌃ H` (Eclipse (macOS)) 中）。

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

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

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

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

![为自定义范围选择颜色](https://resources.jetbrains.com.cn/help/img/idea/2026.3/file-colors-pick-color.png)

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

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

![为自定义范围选择另一种颜色](https://resources.jetbrains.com.cn/help/img/idea/2026.3/change-scope-color.png)

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

如果文件包含在多个作用域中，作用域的顺序就很重要：IntelliJ IDEA 从本地作用域开始，从上到下处理作用域。 这意味着 IDE 会将列表中最后一个作用域的颜色应用于此类文件。

如果希望 IntelliJ IDEA 以不同顺序处理颜色关联，可以更改作用域的顺序。

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)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `外观 & 行为 | 作用域` 。

2. 选择要移动的作用域，然后点击   上移  （ !["向上移动"按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.general.moveUp.svg)）或   下移  （ !["向下移动"按钮](https://resources.jetbrains.com.cn/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)), `Alt+Up` (Visual Studio), `⌥ ↑` (Visual Studio (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)), `Alt+Down` (Visual Studio), `⌥ ↓` (Visual Studio (macOS)), `Alt+Down` (NetBeans), `Alt+Down` (Eclipse), `⌥ ↓` (Eclipse (macOS))。

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

## 作用域用例

以下示例展示如何在日常工作中使用作用域：

* 仅检查特定文件组。 借助作用域，可以检查代码库的特定部分。 例如，可以将生产代码与测试代码分开检查。 此外，可以将另一种检查设置应用于最近修改的文件，以确保新更改经过更严格的检查。 有关更多信息，请参阅 [运行检查](running-inspections.html)。 ![指定检查范围对话框](https://resources.jetbrains.com.cn/help/img/idea/2026.3/inspection_scope.png)

* 限制搜索和替换结果。 可以将作用域与 在文件中查找 和 在文件中替换 功能结合使用，以减少不相关结果的数量并加快重构。 有关更多信息，请参阅 [在项目中搜索并替换目标](finding-and-replacing-text-in-project.html)。 ![在类层次结构中搜索](https://resources.jetbrains.com.cn/help/img/idea/2026.3/class_hierarchy.png)

* 使用作用域进行导航。 在 项目 工具窗口中，作用域还可以 Simplify 导航。 可以选择所需作用域，创建只包含当前所需项的简化树。 有关更多信息，请参阅 [项目工具窗口](project-tool-window.html)。 ![“项目”工具窗口中的作用域](https://resources.jetbrains.com.cn/help/img/idea/2026.3/ij_project_tw_group_tabs_enabled.png)

* 仅重新格式化某些文件。 借助作用域，可以重新格式化特定文件，而不是只重新格式化当前文件或整个代码库。 例如，可以在更改代码后重新格式化最近修改的文件，以符合代码样式要求。 有关更多信息，请参阅 [重新格式化代码](reformat-and-rearrange-code.html)。 ![模块或目录重格式化对话框](https://resources.jetbrains.com.cn/help/img/idea/2026.3/module_directory_reformat.png)

* 为不同的文件设置配置不同的版权声明。 在多种情况下这会很有用，例如，当项目中的文件有不同的版权所有者，或来自第三方或开源项目，并且需要保留原始版权时。 有关更多信息，请参阅 [版权](copyright.html)。 ![将配置文件与作用域关联](https://resources.jetbrains.com.cn/help/img/idea/2026.3/copyright_dialog.png)

## See also

### 过程

[Code inspections](running-inspections.html#run-inspections-manually) [代码重构](refactoring-source-code.html) [随处搜索](searching-everywhere.html) [版权](copyright.html) [依赖性分析](dependencies-analysis.html)

### 参考

[Scopes dialog in Settings](settings-scopes.html) [File Colors dialog in Settings](settings-file-colors.html)

