# 作用域

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

> **TL;DR**
> `文件 | 设置 | 外观与行为 | 作用域`  适用于 Windows 和 Linux
>
>
>
> `%instance% | 设置 | 外观和行为 | 范围`  适用于 macOS
>
>
>
> `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)) !["设置"图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.settings.svg)

请使用此页面配置 [文件作用域](configuring-scopes-and-file-colors.html)。

一个  作用域  ![范围图标](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.ide.localScope.svg) 是 project 中具有名称的文件、软件包和文件夹设置。省略号结束。 作用域可帮助在不同的 IDE 视图中 [直观区分](configuring-scopes-and-file-colors.html#associate-file-color-with-a-scope) project 项，并限制某些操作的范围。

![设置中的 Scopes 页面](https://resources.jetbrains.com/help/img/idea/2026.3/ij-settings-scopes.png)

## 主工具栏

|  条目  |  工具提示  |  描述  |
| --- | --- | --- |
|  !["添加"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)  |       添加作用域      `Alt+Insert` (Windows), `⌘ N` (macOS), `⌃ N` (IntelliJ IDEA Classic (macOS)), `⌘ N` (macOS System Shortcuts), `Alt+Insert` (XWin), `Alt+Insert` (GNOME), `Alt+Insert` (KDE), `Alt+Insert` (Emacs), `Ctrl+N` (Sublime Text), `⌘ N` (Sublime Text (macOS)), `Ctrl+N` (Visual Studio), `⌘ N` (Visual Studio (macOS)), `Alt+Insert` (NetBeans), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS))  |  添加新的 [本地](configuring-scopes-and-file-colors.html#local-sc) 或 [共享](configuring-scopes-and-file-colors.html#shared-sc)作用域。  |
|  !["移除"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.remove.svg)  |       删除      `Alt+Delete` (Windows), `⌘ ⌦` (macOS), `⌘ ⌦` (IntelliJ IDEA Classic (macOS)), `⌘ ⌦` (macOS System Shortcuts), `Alt+Delete` (XWin), `Alt+Delete` (GNOME), `Alt+Delete` (KDE), `Alt+Delete` (Emacs), `Alt+Delete` (Sublime Text), `⌘ ⌦` (Sublime Text (macOS)), `Ctrl+R, D` (Visual Studio), `⌘ R, D` (Visual Studio (macOS)), `Alt+Delete` (NetBeans), `Alt+Delete` (Eclipse), `Alt+Delete` (Eclipse (macOS))  |  从列表中删除所选作用域。  |
|  ![复制配置按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.copy.svg)  |       复制配置      `Ctrl+D` (Windows), `⌘ D` (macOS), `⌘ D` (IntelliJ IDEA Classic (macOS)), `⌘ D` (macOS System Shortcuts), `Ctrl+D` (XWin), `Ctrl+D` (GNOME), `Ctrl+D` (KDE), `Meta+D` (Emacs), `Ctrl+Shift+D` (Sublime Text), `⌘ ⇧ D` (Sublime Text (macOS)), `Ctrl+D` (Visual Studio), `⌘ D` (Visual Studio (macOS)), `Ctrl+D` (NetBeans), `Ctrl+D` (Eclipse), `Ctrl+D` (Eclipse (macOS))  |  创建所选作用域的副本。  |
|  ![“另存为”按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.save.svg)  |    另存为    |  将所选本地作用域另存为共享，或将所选共享作用域另存为本地。  |
|  ![上移按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.moveUp.svg)  ![下移按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.moveDown.svg)  |    上移   /   下移    |  在列表中上下移动作用域。  |

> **Tip:**
> 有关使用作用域的详细信息，请参阅 [作用域和文件颜色](configuring-scopes-and-file-colors.html)。

## 范围配置控制

|  条目  |  描述  |
| --- | --- |
|    名称    |  指定作用域名称。  |
|    模式    |     指定用于定义当前作用域的模式。 可使用以下元素和结构：        1.   `文件：`  修饰符。 该元素是必需的。     2.  文件名或文件扩展名中使用  `*` 星号表示任意符号。     3.  逻辑运算符  `与 (&&)，或 (\|\|)` 、和  `非 (!)` 。       有关更多信息，请参见 [作用域语言语法参考](scope-language-syntax-reference.html)。       不允许存储空或错误的模式。 在这种情况下，IntelliJ IDEA 显示  Syntax Error  警告。     |
|    包含    |  已包含所选项目。 如果当前项目是文件夹，则嵌套的子文件夹将被忽略。  |
|    递归包含    |  包括所选文件夹及其所有嵌套子文件夹和它们的内容。  |
|    排除    |  排除选定项。 如果当前项是文件夹，则嵌套的子文件夹仍保留在作用域中。  |
|    递归排除    |  排除所选文件夹及其所有嵌套子文件夹及其内容。  |

> **Tip:**
> 有关使用作用域的详细信息，请参阅 [作用域和文件颜色](configuring-scopes-and-file-colors.html)。

## 范围工具栏

|  条目  |  工具提示  |  描述  |
| --- | --- | --- |
|  项目树视图  |  |     树状视图包含项目中所有可用的文件。 在视图中，选择要包含在当前作用域中的所需文件，并自动生成作用域定义模式。     |
|  ![“扁平化包”按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.objectBrowser.flattenPackages.svg)  |    扁平化软件包    |  启用此选项时，所有包将显示为单级树视图。 这使您能够通过名称在项目深处找到一个包，而无需浏览整个树层次结构。  |
|  ![按范围类型分组按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.actions.groupByTestProduction.svg)  |    按作用域类型分组    |     按下此按钮时，树视图中的项目将分组到三个节点下：        * 库类    * 生产类    * 测试类      此按钮仅适用于   包   范围的展示。     |
|  ![紧凑中间包按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.objectBrowser.compactEmptyPackages.png)  |    紧凑显示中间软件包    |  此选项允许您指定显示空包的方式或是否显示。 （空包是指仅包含其他包的包。）  |
|  ![显示文件](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.fileTypes.anyType.svg)  |    显示文件    |     启用此选项时，源文件会在树形视图中显式显示。 当文件显示时，您可以选择将其排除/包含在模式中。       如果此选项未被禁用，所有文件将在树中隐藏。     |
|  ![显示模块按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.actions.groupByModule.png)  |    显示模块    |  启用此选项时，树视图中的项目将显示在相应的模块节点下。 否则，项目项显示在对应的包下（如具有包的源路径）。  |
|  ![“扁平化模块”按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.objectBrowser.flattenModules.svg)  |    扁平化模块    |  启用此选项时，模块组中的模块将与其他模块显示在同一级别。  |
|  ![仅显示包含的内容](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.filter.svg)  |    仅显示包含的文件    |  启用此选项后，树仅显示包含在作用域中的元素。  |
|       包           项目       |  |     定义您希望在树视图中显示项目文件的方式。       项目树视图的呈现、 [scopes language syntax](scope-language-syntax-reference.html) 和可用的工具栏按钮会根据选择的不同而有所不同。     |

> **Tip:**
> 有关使用作用域的详细信息，请参阅 [作用域和文件颜色](configuring-scopes-and-file-colors.html)。

## 项目树视图的图例

|  条目  |  描述  |
| --- | --- |
|  ![绿色样本](https://resources.jetbrains.com/help/img/idea/2026.3/green_square.png)  |  包含在作用域中的文件夹和文件以绿色标记。  |
|  黑色  |  排除在作用域之外的文件夹和文件。  |
|  ![深蓝色样本](https://resources.jetbrains.com/help/img/idea/2026.3/blue_square.png)  |  包含被排除和包含的文件及子文件夹的文件夹会被标记为深蓝色。  |

## See also

### 过程

[文件范围与文件颜色](configuring-scopes-and-file-colors.html)

### 参考

[作用域语言语法参考](scope-language-syntax-reference.html) [检查](inspections-settings.html) [文件颜色](settings-file-colors.html)

