范围与文件颜色
scope 是 项目 中的一组文件和文件夹。 您可以使用范围在不同的 IDE 视图中 进行可视化区分 项目 项目,并限制特定操作的作用范围。
范围用于对 项目 中的文件进行逻辑组织:测试源可以归入与测试相关的范围,生产代码可以与生产文件范围关联。 这些逻辑块使管理 项目 更加轻松。 例如,仅在测试类中运行与测试相关的检查,比在整个应用程序中的所有文件中运行更快。
GoLand 附带了一组 预定义范围 ,但您也可以创建自定义范围。 在此,您可以包含任何文件和文件夹。 例如,自定义范围可以仅包含 项目 中由您负责的文件。
在 GoLand 中,范围用于代码检查、部分重构、搜索、版权设置以及各种代码分析功能等。
范围有两种类型: 本地 和 共享。
本地范围 存储在 IDE 配置目录 中,因此不会通过 VCS 共享,也无法供团队其他成员使用。
如果您的 项目 处于 版本控制下,使用共享范围是有意义的。 如果您未使用 VCS,则本地范围足以满足您的需求。
定义新范围
在 GoLand 中包含一组 预定义范围 ,但您也可以定义自己的范围。
按 Ctrl+Alt+S 打开设置,然后选择 。
点击 添加作用域 按钮(
),然后选择要定义的范围类型: 本地 或 共享。
您可以稍后使用 通过VCS 共享 复选框更改所选范围的类型(本地或共享)。

在打开的对话框中,为新范围命名并点击 确定。
向新范围添加文件。 在 项目 树中选择所需条目,然后点击树右侧的其中一个选项:
包含 :包含所选条目。 如果所选为文件夹,此操作仅添加该文件夹中的文件。 所有嵌套子文件夹及其内容将不会被添加。
递归包含 :包含所选文件夹及其所有嵌套子文件夹和内容。
排除 :从范围中排除所选条目。 如果所选为文件夹,此操作仅移除此文件夹内的文件。 所有嵌套子文件夹及其内容仍将保留在范围中。
递归排除 :排除所选文件夹及其所有嵌套子文件夹和内容。
当您将文件添加到作用域时,GoLand 会创建一个表达式并将其显示在 模式(P) 字段中。
您也可以在 模式(P) 字段中手动输入模式,使用 scope language syntax 参考语法,而不是使用按钮。
应用更改并关闭对话框。
为所选作用域显示的文件和文件夹将以不同颜色显示,以帮助您区分哪些内容包含在内,哪些未包含在内:
包含在作用域中的文件和文件夹。
同时包含已排除和已包含文件和文件夹的文件夹。
从所选作用域中排除的文件和文件夹。
创建自定义作用域后,您可以在 项目 工具窗口以及 所有允许限制要应用操作的文件数量的对话框 中找到该作用域。

预定义范围
GoLand 提供一组预定义作用域。 IDE 会根据相关信息自动将文件添加到这些作用域中。 请注意,这些作用域无法修改。
预定义范围列表
项目文件 :包括 项目 内容根目录中的所有文件。
问题 :包括 项目 内容根目录中带有语法错误的文件。
打开文件 :包括所有当前打开的文件。
所有更改的文件 :包括所有最近更改的文件。
临时文件和控制台 :包括位于 临时文件和控制台 目录下 项目 工具窗口中的所有文件。
最近查看的文件 和 最近更改的文件 :包括最近在编辑器中打开或修改的 50 个文件。 要更改最近文件的数量,请按 Ctrl+Alt+S 打开设置,然后选择 高级设置 ,搜索 最近文件的最大数量 字段并指定首选数量。
项目和库 :包括 项目 内容根目录中的所有文件以及所有模块依赖项(库和 SDK)。
Git 跟踪的项目文件 :包括 Git 版本控制中的 项目 内容根目录内的所有文件。
排除 Git 忽略项的项目文件 :包括 Git 版本控制中的和未版本控制的 项目 内容根目录内的所有文件,但排除
.gitignore中指定的文件。打开文件 :包括当前在编辑器中打开的文件。
当前文件 :对应于当前在编辑器中处于活动状态的文件。
本地更改 (这些作用域仅在启用 VCS 集成 时显示)
所有更改的文件 :包括所有变更列表中尚未添加到 VCS 的变更文件。
默认更改列表 :包括来自 默认 变更列表中尚未添加到 VCS 的变更文件。
「变更列表名称」 :包括来自某个自定义变更列表中尚未添加到 VCS 的变更文件。
将范围与颜色关联
属于不同作用域的文件可以在搜索结果、编辑器选项卡以及 项目 工具窗口 Alt+1 中以不同颜色显示。

每个作用域都可以分配一个颜色。 例如,您可以为 打开文件 作用域分配一个颜色,并配置 IDE 在 项目 工具窗口中显示该颜色。 在此情况下,您当前在编辑器中正在处理的文件将在项目树中以颜色标示。 这将使 项目 导航更快速、更便捷。 请注意,文件颜色仅在与作用域关联时有效。
与作用域类似,颜色关联也可以是 本地 或 共享。
本地颜色 仅对您可见,并不会通过 VCS 共享。
创建新的颜色关联
按 Ctrl+Alt+S 打开设置,然后选择 。
请确保选中 启用文件颜色(F) 复选框,然后选择要使用颜色的位置: 在编辑器标签页中使用(T) 或 在项目视图中使用(P)。
如果选中 在项目视图中使用(P) 复选框,您将在 项目 工具窗口 Alt+1 和搜索结果中看到颜色(例如在 在文件中查找 对话框 Ctrl+Shift+F 中)。
点击 添加 按钮(
),选择要为其配置颜色的作用域。
您可以选择一个预定义作用域,或使用 custom scope。
点击所需作用域旁的箭头
,从打开的列表中选择颜色。
要配置自定义颜色,请点击 自定义。

要编辑颜色,请点击 颜色 列中与所需作用域对应的单元格,并从列表中选择新颜色。
要通过 VCS 共享 颜色,请在 通过VCS 共享 列中对应行选择复选框。 如果未选中复选框,则该颜色将在 本地 使用。

应用更改并关闭对话框。
如果某个文件包含在多个作用域中,作用域的顺序就变得非常重要:GoLand 将按照从上到下的顺序处理作用域,从本地作用域开始。 这意味着 IDE 会对该文件应用列表中最后一个作用域的颜色。
如果您希望 GoLand 按不同的顺序处理颜色关联,可以更改作用域的顺序。
更改范围顺序
按下 Ctrl+Alt+S 打开设置,然后选择 。
选择要移动的作用域,然后单击 上移 (
)或 下移 (
)按钮。 或者,按下 Alt+Up 或 Alt+Down。
应用更改并关闭对话框。