WebStorm 2021.1 Help

范围和文件颜色

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

范围旨在逻辑地组织项目中的文件:测试源可以转到与测试相关的范围,生产代码可以与生产文件的范围相关联。这些逻辑块使您的项目更易于管理。例如,仅在测试类中运行与测试相关的检查比在应用程序的所有文件中运行它们花费的时间要少。

WebStorm 带有一组预定义的范围,但您也可以创建自定义范围。在那里,您可以包含任何文件和文件夹。例如,自定义范围只能包括您负责的项目中的那些文件。

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

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

  • 本地范围存储在IDE 配置目录中,这就是为什么它们不通过 VCS 共享并且对团队的其他成员不可用的原因。

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

如果您的项目处于版本控制之下,则使用共享范围是有意义的。如果您不使用 VCS,本地范围将足以满足您的需求。

定义新范围

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

  1. Ctrl+Alt+S打开 IDE 设置并选择外观和行为 | 范围

  2. 单击添加范围按钮并选择您要定义的范围类型:本地共享

    创建新范围:在共享范围和本地范围之间进行选择

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

    使用通过 VCS 共享复选框更改范围的状态
  3. 在打开的对话框中,命名新范围并单击OK

  4. 将文件添加到新范围。在项目树中选择必要的项目,然后单击树右侧的选项之一:

    • 包括:包括选定的项目。如果您包含文件夹,则此操作仅添加位于该文件夹内的文件。不包括所有嵌套的子文件夹及其内容。

    • 递归包含:包含选定的文件夹以及嵌套的子文件夹及其内容。

    • 排除:从范围中排除选定的项目。如果您要排除文件夹,则此操作仅删除位于该文件夹内的文件。所有嵌套的子文件夹及其内容都将保留在范围内。

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

    添加了文件和文件夹的新范围

    当您将文件添加到范围时,WebStorm 会创建一个表达式并将其显示在Pattern字段中。除了使用按钮,您还可以使用范围语言语法参考在模式字段中手动键入模式。

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

当您将项目添加到范围时,它们的名称会相应地更改颜色:

  • 绿色样本绿色:范围内包含的文件夹和文件。

  • 蓝色样本蓝色:包含排除和包含文件和文件夹的文件夹。

  • 排除的文件和文件夹从选定范围中排除的文件和文件夹。

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

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

预定义范围

WebStorm 提供了一组预定义的范围。IDE 根据有关文件的信息自动将文件添加到这些范围。请注意,这些范围无法修改。

预定义范围列表

  • 项目文件:包括项目内容根目录中的所有文件。从配置项目结构中了解更多信息。库和框架不包括在此范围内。

  • 问题:在项目内容根中包含语法错误的文件。

  • Scratches and Consoles:包括位于项目工具窗口中的Scratches and Consoles目录中的所有文件。

  • 测试:此范围仅限于项目测试源根。

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

将范围与颜色相关联

属于不同范围的文件可以在搜索结果、编辑器选项卡和项目工具窗口中以不同颜色突出显示。

在编辑器选项卡和搜索结果中突出显示范围

您可以为每个范围分配自己的颜色。例如,您可以为Open Files范围分配一种颜色,并将 IDE 配置为在Project工具窗口中显示此颜色。在这种情况下,您当前在编辑器中使用的文件将在项目树中着色。这使得项目导航更快更简单。请注意,文件颜色仅与范围相关联。

与范围类似,颜色关联可以是本地的共享的。

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

  • 共享颜色置于版本控制之下,以便从事项目的人可以使用相同的颜色关联。它们存储在 fileColors.xml 文件中 .idea 下的项目文件夹中例如MyProject/.idea/fileColors.xml)。

创建新的颜色关联

  1. Ctrl+Alt+S打开 IDE 设置并选择外观和行为 | 文件颜色

  2. 确保选中Enable File Colors复选框,然后选择要使用颜色的位置:选择Use in Editor TabsUse in Project View

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

  3. 单击添加按钮并选择要为其配置颜色的范围。

    您可以选择其中一个预定义范围或使用自定义范围

  4. 右箭头图标单击所需范围旁边的箭头,然后从打开的列表中选择一种颜色。

    要配置您自己的颜色,请单击自定义

    为自定义范围选择颜色
  5. 要编辑颜色,请单击与颜色列中所需范围相对应的单元格,然后从列表中选择一种新颜色。

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

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

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

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

更改范围的顺序

  1. Ctrl+Alt+S打开 IDE 设置并选择外观和行为 | 范围

  2. 选择要移动的范围,然后单击上移按钮( Alt+Up) 或下移按钮( Alt+Down)。

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

最后修改时间:2021 年 12 月 8 日