JetBrains Rider 2025.2 Help

文件作用域与文件颜色

一个 范围 作用域图标 是 解决方案 中的一组文件和文件夹。 您可以使用作用域来 直观区分解决方案 项目在不同 IDE 视图中的显示,并限制特定操作的作用域。

作用域旨在在您的 解决方案 中逻辑地组织文件:测试源代码可以归入测试相关作用域,而生产代码可以关联到生产文件作用域。 这些逻辑块使您的 解决方案 更易于管理。

JetBrains Rider 提供了一组 预定义作用域 ,但您也可以创建自定义作用域。 在那里,您可以包含任何文件和文件夹。 例如,自定义作用域可以仅包含 解决方案 中您负责的文件。

作用域有两种类型: 本地共享

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

  • 共享作用域 被添加到版本控制系统 (VCS),以便在 解决方案 上工作的人员可以使用相同的作用域。 这些作用域与 解决方案 一起存储在 scopes 文件夹下 .idea 。 每个 scope 都会保存为一个文件,并带有 .xml 扩展名(例如: My解决方案.idea/scopes/shared-scope.xml )。

如果您的 解决方案 受 版本控制 ,那么使用共享作用域是有意义的。 如果您不使用 VCS,本地作用域就足以满足您的需求。

定义一个新的作用域

在 JetBrains Rider 中,有一组 预定义作用域 ,但您也可以定义自己的作用域。

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

  2. 请点击 添加作用域 按钮(添加作用域按钮 ),然后选择您要定义的作用域类型: localshared

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

    创建新作用域:选择共享作用域还是本地作用域
  3. 在打开的对话框中,命名新作用域,然后点击 确定

  4. 将文件添加到新作用域。 在 解决方案 树中选择必要的项目,然后点击树右侧的一个选项:

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

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

    • 排除 :将所选项目排除在作用域之外。 如果您排除了一个文件夹,此操作仅会删除位于该文件夹内的文件。 所有嵌套的子文件夹及其内容将保留在作用域内。

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

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

    您也可以手动在 模式(P) 字段中输入一个模式,使用 作用域语言语法参考。

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

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

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

  • 深蓝色样本 包含已排除和已包含文件及文件夹的文件夹。

  • 黑色样本 从所选作用域中排除的文件和文件夹。

预定义范围

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

预定义作用域列表

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

  • 临时文件和控制台 :包含 临时文件和控制台 目录中位于 资源管理器 工具窗口中的所有文件。

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

  • Git 跟踪的项目文件 :包含 解决方案 内容根内在 Git 中受版本控制的所有文件。

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

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

  • 选定文件 :包含在工具窗口中选定的文件(例如,在 资源管理器 工具窗口 Alt+1 中)。

  • 本地更改 (如果 启用 VCS 集成 ,这些作用域将出现)

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

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

    • 'Changelist name' :包括尚未添加到 VCS 的特定自定义更改列表中的已修改文件。

将作用域与颜色关联

属于不同作用域的文件可以在搜索结果、编辑器选项卡和 资源管理器 工具窗口 Alt+1 中以不同颜色高亮显示。

编辑器选项卡和搜索结果中的作用域高亮显示

对每个作用域,您可以分配其自己的颜色。 例如,您可以为 打开文件 作用域分配一种颜色,并配置 IDE 在 资源管理器 工具窗口中显示此颜色。 在这种情况下,您当前在编辑器中处理的文件将在项目树中以颜色显示。 这使得 解决方案 的导航更快更简单。 请注意,文件颜色仅在与作用域关联时起作用。

同样,颜色关联可以是 局部的共享的

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

  • 共享颜色 受到版本控制,因此在 解决方案 上工作的人员可以使用相同的颜色关联。 它们存储在 .idea 的 解决方案 文件夹中的 fileColors.xml 文件里(例如: My解决方案/.idea/fileColors.xml )。

创建新的颜色关联

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

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

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

    您可以选择一个预定义作用域或使用一个 custom scope

  4. 点击必要作用域旁边的箭头 右箭头图标 ,然后从打开的列表中选择一种颜色。

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

  5. 要编辑颜色,请点击 颜色 列中对应于所需作用域的单元格,然后从列表中选择一个新颜色。

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

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

如果一个文件包含在多个作用域内,作用域的顺序就变得很重要:JetBrains Rider 从顶部到底部依次处理作用域,从本地作用域开始。 这意味着 IDE 会将列表中最后一个作用域的颜色应用于这样的文件。

您可以更改作用作用域的顺序,以便 JetBrains Rider 按不同的顺序处理颜色关联。

更改作用域顺序

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

  2. 请选择需要移动的作用域,然后点击 上移 ("向上移动"按钮) 或 下移 ("向下移动"按钮) 按钮。 或者,按 Alt+UpAlt+Down

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

作用域语言语法参考

描述

模式

示例

通过文件名包含单个文件

file:<directory>/<file>

file:databases/create_schema.sql

包含目录中所有文件的集合,不包括子目录

file:<directory>/*

file:databases/mysql-db/*

包含目录及其子目录中所有文件的集合

file:<directory>//*

file:databases/mysql-db//*

通过文件名从特定项目中包含文件

file[project_name]:<directory>/<file>

file[default]:databases/create_schema.sql

可能的逻辑运算符 &&·(与),||·(或),!·(非)。

file[project_name]:<directory>&&!file:<directory>

file[default]:databases/*&&!file:databases/create_schema.sql

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