WebStorm 2025.2 Help

范围与文件颜色

范围 范围图标 是 项目 中的一组文件和文件夹。 范围可用于 在不同的 IDE 视图中直观区分 项目 项目项,并限制特定操作的范围。

范围旨在对 项目 中的文件进行逻辑组织:测试源代码可以归入与测试相关的范围,生产代码可以关联到生产文件的范围。 这些逻辑部分使您的 项目 更易于管理。 例如,仅在测试类中运行与测试相关的检查比在应用程序中的所有文件中运行这些检查耗时更少。

WebStorm 提供一组 预定义范围 ,但您也可以创建自定义范围。 在此,您可以包含任意文件和文件夹。 例如,自定义范围可以只包含您在 项目 中负责的文件。

在 WebStorm 中,范围用于代码检查、部分重构、搜索、版权设置、各种代码分析功能等。

有两种范围类型: 本地共享

  • 本地作用域 存储在 IDE 配置目录中,因此不会通过 VCS 共享,也不会对团队中的其他成员可见。

  • 共享作用域 被添加到 VCS 中,方便参与同一 项目 的人员使用相同的范围。 这些范围与 项目 一同存储在 scopes 文件夹下的 .idea 中。 每个范围都保存为扩展名为 .xml 的文件(例如: My项目/.idea/scopes/shared-scope.xml )。

如果 项目 使用了 版本控制 ,使用共享范围更有意义。 如果不使用 VCS,本地范围就足以满足您的需求。

定义新范围

在 WebStorm 中,提供了一组 预定义范围 ,但您也可以定义自己的范围。

  1. Ctrl+Alt+S 打开设置,然后选择 外观与行为 | 作用域

  2. 单击 添加作用域 按钮(添加范围按钮 ),然后选择要定义的范围类型: 本地共享

    创建新范围:选择共享范围或本地范围

    稍后可通过 通过VCS 共享 复选框更改所选范围的状态(本地或共享)。

    使用“通过 VCS 共享”复选框更改范围的状态
  3. 在打开的对话框中,为新范围命名并点击 确定

  4. 将文件添加到新范围。 在 项目 树中选择所需项目,然后点击位于树右侧的某个选项:

    • 包含 :包含所选项目。 如果添加的是文件夹,此操作仅添加此文件夹内的文件。 所有嵌套子文件夹及其内容将不会被添加。

    • 递归包含 :包含所选文件夹及其所有嵌套子文件夹和内容。

    • 排除 :将所选项目从范围中排除。 如果您排除了一个文件夹,此操作仅会移除该文件夹内的文件。 所有嵌套的子文件夹及其内容将仍保留在作用域中。

    • 递归排除 :排除选定文件夹及其嵌套的子文件夹和内容。

    带有已添加文件和文件夹的新范围

    当您向作用域添加文件时,WebStorm 会创建一个表达式并将其显示在 模式(P) 字段中。

    除了使用按钮外,您还可以手动在 模式(P) 字段中输入模式,参考 scope language syntax

    例如,为避免对已压缩的文件再次进行压缩,请使用 file:*js&&!file:*.min.* 模式配置一个自定义作用域。

    手动输入模式
  5. 应用更改并关闭对话框。

为所选作用域显示的文件和文件夹将以不同颜色显示,帮助您了解哪些被包含,哪些未被包含:

  • 绿色颜色示例 被包含在作用域中的文件和文件夹。

  • 深蓝色颜色示例 同时包含被排除和被包含文件及文件夹的文件夹。

  • 黑色颜色示例 被排除在所选作用域之外的文件和文件夹。

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

在“项目”工具窗口中显示的新范围

预定义范围

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

预定义范围列表

  • 项目文件 :包括 项目 内容根目录中的所有文件。 详细了解请参阅 配置项目结构。 此作用域不包括库与框架。

  • 问题 :包括 项目 内容根目录中具有语法错误的文件。

  • 所有更改的文件 :包括所有最近更改过的文件。

  • 临时文件和控制台 :包括在 项目 工具窗口中的 临时文件和控制台 目录中所有文件。

  • 最近查看的文件最近更改的文件 :包括编辑器中最近打开或修改的 50 个文件。 要更改最近文件的数量,请按 Ctrl+Alt+S 打开设置,并选择 高级设置 ,然后搜索 最近文件的最大数量 字段并指定所需的数量。

  • Git 跟踪的项目文件 :包括 项目 内容根目录中受 Git 版本控制的所有文件。

  • 排除 Git 忽略项的项目文件 :包括 项目 内容根目录中受 Git 版本控制和未版本控制的所有文件,但不包括在 .gitignore 中指定的文件。

  • 测试 :此作用域仅限于 项目 测试源根目录。

  • 打开文件 :包括当前在编辑器中打开的文件。

  • 当前文件 :对应当前在编辑器中处于活动状态的文件。

  • 选定文件 :包括在工具窗口中选中的文件(例如,在 项目 工具窗口 Alt+1 中)。

  • 本地更改 (仅当 启用了 VCS 集成时显示这些作用域)

    • 所有更改的文件 :包括所有变更列表中尚未添加到 VCS 的已修改文件。

    • 默认更改列表 :包括 默认 变更列表中尚未添加到 VCS 的已修改文件。

    • “变更列表名称” :包括特定自定义变更列表中尚未添加到 VCS 的已修改文件。

  • 数据源

    • 上下文数据源 :包括您当前正在使用的数据源。 上下文可通过当前使用的控制台、数据编辑器或在数据库资源管理器中选择来定义。

    • 已连接数据源 :包括具有活动连接的数据源。

    • 所有数据源 :包括所有已添加的数据源。

将范围与颜色关联

属于不同作用域的文件可以在搜索结果、编辑器选项卡以及 项目 工具窗口 Alt+1 中以不同颜色突出显示。

在编辑器标签和搜索结果中突出显示范围

可以为每个作用域分配其专属颜色。 例如,您可以为 打开文件 作用域分配一种颜色,并配置 IDE 在 项目 工具窗口中显示该颜色。 在这种情况下,您当前在编辑器中使用的文件将在项目树中以颜色显示。 这使得 项目 导航更快速、更简便。 请注意,文件颜色仅在与作用域相关时才起作用。

与作用域类似,颜色关联可以是 本地共享的。

  • 本地颜色 仅对您可见,不通过 VCS 共享。

  • 共享颜色 已置于版本控制之下,便于参与 项目 的其他人员使用相同的颜色关联。 它们存储在 项目 文件夹中的 .idea 下的 fileColors.xml 文件中(例如: My项目/.idea/fileColors.xml )。

创建新的颜色关联

  1. Ctrl+Alt+S 打开设置,然后选择 外观与行为 | 文件颜色

  2. 请确保选中 启用文件颜色(F) 复选框,然后选择要使用颜色的位置:选择 在编辑器标签页中使用(T)在项目视图中使用(P)

    如果选中 在项目视图中使用(P) 复选框,您将在 项目 工具窗口 Alt+1 和搜索结果中看到颜色(例如,在 在文件中查找 对话框 Ctrl+Shift+F 中)。

  3. 单击 添加 按钮(添加图标 ),然后选择要为其配置颜色的作用域。

    您可以选择一个预定义作用域,或使用 自定义作用域

  4. 点击所需作用域旁的箭头 右箭头图标 ,并从打开的列表中选择颜色。

    如需配置自定义颜色,请单击 自定义

    为自定义范围选择颜色
  5. 如需编辑颜色,请单击 颜色 列中与所需作用域对应的单元格,并从列表中选择新颜色。

  6. 要通过 VCS 共享颜色,请在 通过VCS 共享 列中相应的行上选中复选框。 如果未选中复选框,该颜色将 仅在本地 使用。

    为自定义范围选择其他颜色
  7. 应用更改并关闭对话框。

如果某个文件包含在多个作用域中,则作用域的顺序变得十分重要:WebStorm 会从上至下处理作用域,从本地作用域开始。 这意味着 IDE 会将列表中最后一个作用域的颜色应用于此类文件。

如果您希望 WebStorm 以不同的顺序处理颜色关联,您可以更改作用域的顺序。

更改范围顺序

  1. Ctrl+Alt+S 打开设置,然后选择 外观与行为 | 作用域

  2. 选择要移动的作用域,然后单击 上移上移按钮 )或 下移下移按钮 )按钮。 或者,按 Alt+UpAlt+Down

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

最后修改日期: 2025年 9月 26日