GoLand 2025.2 Help

范围与文件颜色

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

范围用于对 项目 中的文件进行逻辑组织:测试源可以归入与测试相关的范围,生产代码可以与生产文件范围关联。 这些逻辑块使管理 项目 更加轻松。 例如,仅在测试类中运行与测试相关的检查,比在整个应用程序中的所有文件中运行更快。

GoLand 附带了一组 预定义范围 ,但您也可以创建自定义范围。 在此,您可以包含任何文件和文件夹。 例如,自定义范围可以仅包含 项目 中由您负责的文件。

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

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

  • 本地范围 存储在 IDE 配置目录 中,因此不会通过 VCS 共享,也无法供团队其他成员使用。

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

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

定义新范围

在 GoLand 中包含一组 预定义范围 ,但您也可以定义自己的范围。

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

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

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

    创建新范围
  3. 在打开的对话框中,为新范围命名并点击 确定

  4. 向新范围添加文件。 在 项目 树中选择所需条目,然后点击树右侧的其中一个选项:

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

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

    • 排除 :从范围中排除所选条目。 如果所选为文件夹,此操作仅移除此文件夹内的文件。 所有嵌套子文件夹及其内容仍将保留在范围中。

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

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

    您也可以在 模式(P) 字段中手动输入模式,使用 scope language syntax 参考语法,而不是使用按钮。

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

为所选作用域显示的文件和文件夹将以不同颜色显示,以帮助您区分哪些内容包含在内,哪些未包含在内:

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

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

  • 黑色颜色示例 从所选作用域中排除的文件和文件夹。

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

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

预定义范围

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

预定义范围列表

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

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

  • 打开文件 :包括所有当前打开的文件。

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

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

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

  • 项目和库 :包括 项目 内容根目录中的所有文件以及所有模块依赖项(库和 SDK)。

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

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

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

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

  • 本地更改 (这些作用域仅在启用 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. 点击 添加 按钮(添加图标 ),选择要为其配置颜色的作用域。

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

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

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

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

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

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

如果某个文件包含在多个作用域中,作用域的顺序就变得非常重要:GoLand 将按照从上到下的顺序处理作用域,从本地作用域开始。 这意味着 IDE 会对该文件应用列表中最后一个作用域的颜色。

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

更改范围顺序

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

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

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

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