# 作用域

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/clion/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)), `⌘ 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)) !["设置"图标](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) 是 项目 中具名称的一组文件和文件夹。 作用域有助于在不同的 IDE 视图中 [直观地区分](configuring-scopes-and-file-colors.html#associate-file-color-with-a-scope) 项目 项，并限制某些操作的范围。

## 主工具栏

|  项  |  提示  |  描述  |
| --- | --- | --- |
|  ![添加按钮](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)), `⌘ N` (Xcode), `Ctrl+N` (Visual Studio), `⌘ N` (Visual Studio (macOS)), `Alt+Insert` (ReSharper), `⌥ Insert` (ReSharper (macOS)), `Alt+Insert` (QtCreator), `Alt+Insert` (QtCreator (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)), `⌘ ⌦` (Xcode), `Ctrl+R, D` (Visual Studio), `⌘ R, D` (Visual Studio (macOS)), `Alt+Delete` (ReSharper), `⌥ ⌦` (ReSharper (macOS)), `Alt+Delete` (QtCreator), `⌘ ⌦` (QtCreator (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)), `⌘ D` (Xcode), `Ctrl+D` (Visual Studio), `⌘ D` (Visual Studio (macOS)), `Ctrl+D` (ReSharper), `⌘ D` (ReSharper (macOS)), `Ctrl+D` (QtCreator), `⌘ D` (QtCreator (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)  |    上移   /   下移    |  在列表中上下移动作用域。  |

## 作用域配置控制

|  项  |  描述  |
| --- | --- |
|    名称    |  指定作用域名称。  |
|    Pattern    |     指定定义当前作用域的模式。 可以使用以下元素和结构：        1.   `file:`  修饰符。 该元素是必需的。     2.  文件名或文件扩展名中使用  `*` 星号表示任意符号。     3.  逻辑运算符  `AND (&&), OR (\|\|)` 、和  `NOT (!)` 。       欲了解更多信息，请参阅 [作用域语言语法参考](scope-language-syntax-reference.html)。       不允许存储空或错误的模式。 在这种情况下，CLion 显示  Syntax Error  警告。      ### 示例          * `file:*.js\|\|file:*.coffee` - 包括所有 JavaScript 和 CoffeeScript 文件。    * `file:*js&&!file:*.min.*` - 包含所有 JavaScript 文件，但通过 minification 生成的文件除外，这些文件由 `min` 扩展名指示。    * `!file:*/.npm//*` - 排除所有 `.npm` 文件夹。      |
|    包含    |  已包含所选项目。 如果当前项目是文件夹，则嵌套的子文件夹将被忽略。  |
|    递归包含    |  包括所选文件夹及其所有嵌套子文件夹和它们的内容。  |
|    排除    |  排除选定项。 如果当前项是文件夹，则嵌套的子文件夹仍保留在作用域中。  |
|    递归排除    |  排除所选文件夹及其所有嵌套子文件夹及其内容。  |

## 作用域工具栏

|  项  |  提示  |  描述  |
| --- | --- | --- |
|  项目树视图  |  |     树状视图包含项目中所有可用的文件。 在视图中，选择要包含在当前作用域中的文件，并自动生成作用域定义模式。     |
|  ![显示文件](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.fileTypes.anyType.svg)  |    显示文件    |     启用此选项时，源文件会在树形视图中显式显示。 当文件显示时，您可以选择将其排除/包含在模式中。       如果此选项未被禁用，所有文件将在树中隐藏。     |
|  ![仅显示包含的内容](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.filter.svg)  |    仅显示包含的文件    |  启用此选项后，树仅显示包含在作用域中的元素。  |

## 项目树视图的图例

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

