RubyMine 2026.1 Help

文件范围与文件颜色

一个 作用域 范围图标 是 project 中具有名称的一组文件和文件夹。 作用域可帮助您在不同的 IDE 视图中 直观地区分 project 项,并限制某些操作的范围。

作用域可帮助您逻辑地组织文件。 例如,您可以将测试源放入测试作用域中,将生产代码保留在生产作用域中。 这使得处理大型 project 更加轻松。 仅对测试运行检查比在整个代码库上运行检查更快。

RubyMine 随附一组 预定义作用域 ,但您也可以创建自己的作用域。 自定义作用域可以包含任意文件集,例如,您负责的 project 部分。

在 RubyMine 中,作用域用于 各种功能 :代码检查、部分重构、搜索、版权设置、各种代码分析功能等。

在 RubyMine 中,作用域有两种类型:本地和共享。

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

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

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

定义一个新的范围

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

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

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

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

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

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

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

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

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

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

    添加了文件和文件夹的新作用域

    当您将文件添加到范围时,RubyMine 会创建一个表达式,并将其显示在 Pattern 字段中。

    您也可以手动在 Pattern 字段中输入模式,使用 范围语言语法参考。

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

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

  • 绿色示例 包含在范围内的文件和文件夹。

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

  • 黑色样本 从所选范围中排除的文件和文件夹。

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

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

预定义范围

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

预定义范围列表

  • 项目文件 :包括 project 内容根目录中的所有文件。

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

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

  • 临时文件与控制台 :包含 临时文件与控制台 目录中位于 Project 工具窗口中的所有文件。

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

  • 项目和库 :包含 project 内容根中的所有文件以及所有模块依赖项(库和解释器)。

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

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

  • 项目生产文件 :包括 project 内容根目录内的所有文件,测试源目录除外。

  • 项目测试文件 :包括测试源根目录中的文件。 在 Project 工具窗口(Alt+1 )中,此范围对应于 测试 视图。

  • 非项目文件 :此范围仅可在 Project 工具窗口中作为视图使用。 它包括库和解释器。

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

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

  • 选定文件 :包含在工具窗口中所选的文件(例如,在 Project 工具窗口(Alt+1 )中)。

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

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

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

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

将范围与颜色关联

属于不同作用域的文件可以在搜索结果、编辑器标签页以及 Project 工具窗口(Alt+1 )中以不同颜色高亮显示。

编辑器选项卡和搜索结果中的范围高亮显示

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

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

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

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

创建新的颜色关联

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

  2. 请确保选中 启用文件颜色 复选框,然后选择您要使用颜色的位置:选择 在编辑器选项卡中使用在项目视图中使用

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

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

    您可以选择一个预定义范围或使用一个 custom scope

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

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

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

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

    通过 VCS 共享颜色。
  7. 应用更改并关闭对话框。

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

您可以更改作用范围的顺序,以便 RubyMine 按不同的顺序处理颜色关联。

更改范围顺序

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

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

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

作用域用例

以下示例展示了您在日常工作中如何使用作用域:

  • 仅检查特定文件组。

    使用作用域,您可以检查代码库的特定部分。 例如,您可以分别检查生产代码和测试代码。 此外,您可以对最近修改的文件应用不同的检查集,以确保新更改经过更严格的检查。

    请从 运行检查 了解更多。

  • 限制搜索和替换结果。

    您可以将作用域与 在文件中查找在文件中替换 功能配合使用,以减少无关结果并加快重构速度。

    请从 在项目中查找并替换目标 了解更多。

    限制搜索和替换结果
  • 使用作用域进行导航。

    Project 工具窗口中,作用域也可以简化导航。 您可以选择所需的作用域,仅使用当前需要的项目创建一个简化的树形结构。

    请从 项目工具窗口 了解更多。

    项目工具窗口中的作用域
  • 仅重新格式化特定文件。

    通过作用域,您可以重新格式化指定的文件,而不是只重新格式化当前文件或整个代码库。 例如,您可以在更改代码后,重新格式化最近修改的文件以符合代码样式要求。

    请从 重新格式化和重新排列代码 了解更多。

    选择用于重新格式化的作用域
  • 为不同的文件集配置不同的版权声明。

    这在多种情况下很有用,例如,当项目中的文件属于不同的版权方,或来自第三方或开源项目,并且您希望保留原始版权时。

    请从 版权 了解更多。

    将配置文件与作用域关联
2026年 3月 24日