Project 工具窗口

项目工具窗口 Alt+1 可帮助您从不同视角查看项目并执行多项任务，例如创建新项（目录、文件、类等），在编辑器中打开文件，导航到所需的代码片段等等。

视图

该工具窗口提供多个视图：

项目视图。该视图显示所有项目项及其依赖关系（SDK 和库）。该视图以目录结构为重点，尽管也会显示包。
范围视图（项目文件、打开的文件等）。这些视图会显示预定义范围和用户自定义范围的内容。在其他方面，根据当前所选的视图选项，范围视图可能类似于项目或包视图。
暂存区和控制台视图。该视图可让您管理临时文件和查询控制台。

要在各视图间切换，请按 Alt+Right/Alt+Left ，或从标题栏列表中选择视图。

您也可以在单独的标签页中显示每个视图：点击并取消选中标签页分组选项。下图显示的是项目工具窗口中禁用了标签页分组选项时的标签页。

下图中启用了标签页分组选项。

外观与行为

快速添加文件和文件夹

您可以通过工具窗口的工具栏创建新文件或文件夹。可用选项取决于在工具窗口中所选的节点。

在工具窗口工具栏中点击，并从列表中选择一个选项。
使用快速搜索可更快找到选项：开始键入要创建的文件类型，以缩小结果范围。

预览文件

有两种方式可以在不打开单独标签页的情况下预览文件：

使用文件预览弹窗：在项目工具窗口中选择文件 Alt+1 ，然后按 Space。
启用预览标签页：点击并选择行为｜启用预览标签页。

显示文件大小和修改时间戳

您可以查看项目树中各文件的大小及修改时间戳。

在项目工具窗口 Alt+1 中，点击并选择外观｜文件详细信息。

显示树状缩进指引

在项目工具窗口中，您可以显示用于指示缩进层级的垂直线，从而更清晰地理解项目中各组件的层级结构。

按 Ctrl+Alt+S 打开设置，然后选择外观和行为｜外观。
在树状视图部分，启用显示缩进指南选项。

单击打开文件

您可以将项目工具窗口配置为通过单击在编辑器中打开文件。

在项目工具窗口中，点击并启用行为｜一键打开文件选项。

在 Project 工具窗口中快速定位文件

GoLand 可帮助您在项目工具窗口中自动选中当前活动编辑器标签页中打开的文件，便于追踪。

在项目工具窗口中，点击并启用行为｜始终选择打开的文件选项。

标题栏上下文菜单

右键点击标题栏或点击选项按钮后出现的上下文菜单中，提供了用于配置项目视图、查看模式的设置，还可以在视图间切换、调整工具窗口大小等。

下表列出了可用命令和选项并提供简要说明。

项目

快捷键

描述

选择下一个视图或标签页

Alt+Right

使用此选项可在不同视图间切换。

仅在禁用分组标签页时，此选项才可用。

选择上一个视图或标签页

Alt+Left

使用此选项可在不同视图间切换。

仅当分组标签页被禁用时，此选项才可用。

显示视图或标签页列表

Alt+Down

使用此选项可在不同视图之间切换。

仅当分组标签页被禁用时，此选项才可用。

行为

启用预览标签页

启用预览标签页，可在单一标签页中逐个查看文件，而无需为每个文件打开新标签页。

一键打开文件

单击项目工具窗口中的项目，即可在编辑器中打开。否则，您需要双击项目才能打开。

请注意，如果启用了预览标签页，则无法禁用此选项。

单击一次打开目录

单击一次即可在项目工具窗口中展开或折叠目录。否则，您需要双击目录才能打开，或使用目录名称旁的图标。

始终选择打开的文件

启用该选项后，GoLand 会自动在此窗口的当前视图中定位您在编辑器中打开的文档。

外观

成员

启用该选项后，包含类的树中文件将变为节点。展开这些节点时，会显示所选项目中包含的类及其字段、方法和其他成员。

分组标签页：开	分组标签页：关

排除的文件

此选项仅在项目视图中可用。

打开或关闭此选项以显示或隐藏已排除的文件夹和文件。

暂存区和控制台

隐藏或显示暂存区和控制台节点。

该节点包含您的临时文件和查询控制台。

文件详细信息

选中此选项可显示文件的大小和修改时间戳。

文件嵌套

打开文件嵌套对话框，在其中可以配置具有相同名称但扩展名不同的文件的呈现方式。

自定义树状视图

导航至设置｜外观和行为｜外观｜树状视图以配置树视图选项。

排序依据

名称

按名称的字母顺序对文件进行排序。

此选项不影响文件夹的顺序，文件夹始终按字母顺序排序。

类型

按扩展名对文件进行排序。

此选项不影响文件夹的顺序，文件夹始终按字母顺序排序。

修改时间（最新优先／最旧优先）

按修改时间对文件进行排序。要显示此信息，请从主菜单中选择视图｜外观｜树状视图中的详细信息。

此选项不影响文件夹的顺序，文件夹始终按字母顺序排序。

文件夹总在最前

启用该选项后，文件夹将显示在文件上方。否则，所有项目将按字母顺序排列，文件与文件夹混合显示。

编辑作用域

打开作用域对话框，可在其中创建和编辑用户定义的范围。

请注意，该命令仅在当前视图为范围视图时可用。

快速搜索

Ctrl+F

搜索项目。详细了解请参阅工具窗口中的快速搜索

标签页分组

启用该选项后，标题左侧会显示一个列表，您可从中选择所需视图。

禁用该选项时，视图将以标签的形式显示在标题左侧。

分组标签页：开	分组标签页：关

视图模式

此选项可让您控制工具窗口的一般外观和行为。完整信息请参阅工具窗口视图模式。

移至

要将工具窗口关联到其他工具窗口栏，请选择此命令，然后选择目标工具窗口栏（顶部、左侧、底部或右侧）。完整信息请参阅移动工具窗口章节。

调整大小

要通过移动边框来调整工具窗口大小，请选择此命令，然后选择所需的拉伸到选项。

请注意，此命令在浮动模式下不可用。

从边栏中移除

此命令会隐藏工具窗口，从工具窗口栏中移除关联的工具窗口按钮，并从快速访问菜单（或）中移除该工具窗口。

要重新打开工具窗口（并恢复相关功能），请使用主菜单：视图 | 工具窗口 | <窗口名称> ，或按 Alt+1。

隐藏

Shift+Escape

隐藏工具窗口。

帮助

此命令将在 GoLand 在线帮助中打开项目工具窗口的说明。

标题栏操作

项目	快捷键	说明
选择下一个视图或标签页选择上一个视图或标签页	`Alt+Right` `Alt+Left`	如果目前通过标签页显示视图（分组标签页选项已关闭），该按钮会出现在最后一个可见标签页的右侧。打开视图列表，例如用于选择其他视图。
		从编辑器中的文件导航至项目工具窗口 `Alt+1` 中相应的节点（文件、类、字段、方法等）。如果已启用始终选中已打开的文件选项，则该图标不可用。
	`Ctrl+NumPad +`	展开所有节点。
	`Ctrl+NumPad -`	折叠所有节点。
		打开菜单以配置当前视图并更改工具窗口视图模式。可用选项为标题栏上下文菜单项目子集。请注意，大多数菜单项是可开关的选项。已启用的选项在其名称左侧会显示勾选标记。
	`Shift+Escape`	隐藏工具窗口 `Shift+Escape`。要隐藏所有工具窗口，请按 `Ctrl+Shift+F12`。

内容面板

内容窗格显示项目项，例如目录、文件和其他元素。

项目	说明
	文件夹（目录）。不同类别的文件夹具有不同的颜色。不同文件夹类别具有不同的颜色。
	标记为纯文本的文件。

内容面板项的上下文菜单命令

项目的上下文菜单可访问该项目的所有可用功能。

项目	快捷键	说明
新建	`Alt+Insert`	在所选项内创建新项目（目录、文件或类）。（项目或目录）。
剪切	`Ctrl+X`	将选中的项目从当前位置移动到剪贴板。
复制(C)	`Ctrl+C`	将选中的项目复制到剪贴板。
复制路径/引用		使用此命令以及以下其中一项选项，将选中的项目复制到剪贴板：绝对路径：复制所选项目的完整路径。文件名：仅将文件名复制到剪贴板。来自内容根的路径：复制相对于包含应用内容文件的目录的路径。仓库根路径：复制相对于项目版本库的路径。 GitHub 仓库 URL ：复制相对于 GitHub 上项目版本库的路径。工具箱URL ：如果已安装 GoLand Toolbox，您可以在浏览器中插入复制的路径以使用所选项目打开 Toolbox 应用程序。复制引用(Y) （`Ctrl+Alt+Shift+C` ）：复制包含行号的所选项目引用。
粘贴	`Ctrl+V`	将剪贴板中的内容插入到选定位置。
跳转到源	`F4`	在编辑器中打开所选文件。如果该文件已打开，将激活相应的编辑器选项卡。
查找用法	`Alt+F7`	查找所选项的使用情况。（将打开查找用法对话框。）
在文件中查找	`Ctrl+Shift+F`	执行文本查找。（将打开在文件中查找对话框。）
在文件中替换	`Ctrl+Shift+R`	执行文本查找和替换。（将打开路径替换对话框。）
重命名	`Shift+F6`	重命名所选项目。
重构		对所选项目执行可用的重构操作之一。
书签		将所选项目添加到现有或新建的书签列表。
重新格式化代码	`Ctrl+Alt+L`	重新格式化所选文件中的源代码，或当前目录下所有文件中的源代码。另请参阅重新格式化并重新排列代码。
删除	`Delete`	删除所选项目。请谨慎操作！请谨慎操作！
更改方言（<CurrentDialect>）		对于 SQL 文件和查询控制台，更改与文件或控制台关联的 SQL 方言。
运行 '<item_name>'	`Ctrl+Shift+F10`	对于 SQL 文件或查询控制台：执行所选文件或控制台中包含的所有语句。
在右侧拆分中打开	`Shift+Enter`	Split the editor into two parts and show the file in the right section. 欲了解更多信息，请参阅拆分屏幕。
打开方式		在系统文件管理器或 Terminal 中打开文件。
本地历史记录		查看所选文件或目录的本地历史记录，或为当前版本的项目创建标记。
同步 “<item_name>”		将工具窗口中的视图与文件系统中保存的视图同步。如果您在外部更改了文件或目录的内容，在某些情况下 GoLand 可能不会检测到相关更改，除非您使用此命令。
比较	`Ctrl+D`	Compare the selected file or directory with another file or directory. 请参阅比较文件、文件夹与文本源和文件夹差异查看器。
将文件与编辑器比较		Compare the selected file with the file open on an active editor tab. 请参阅比较文件、文件夹与文本源和文件差异查看器。
外部工具		启动第三方工具。
标记目录		将所选目录标记为源代码根、测试源代码根、排除目录等。通过子菜单选择目录所需的类别。
图表	`Ctrl+Alt+Shift+U` 或 `Ctrl+Alt+U`	为所选项目打开图表（例如 UML 图）。

文件状态高亮显示

如果为当前项目启用了版本控制集成，GoLand 会在项目工具窗口中使用颜色表示 VCS 文件状态。

您可以在版本控制｜文件状态颜色设置页面 Ctrl+Alt+S 中配置 VCS 文件状态颜色。

下表列出了默认文件状态颜色及其在某些配色方案中的含义。

颜色	文件状态	说明
#0A7700	已添加	活动 changelist 中的文件已计划添加到版本库中。
#0EAA00	在非活动 changelist 中添加	The file in an inactive changelist is scheduled for addition to the repository. 启用高亮显示非活动变更列表中的文件选项并在设置｜版本控制｜变更列表中设置后可使用此文件状态。
#FF0000	changelist 冲突	The file in an inactive changelist has been modified in the active changelist. 在此情况下，将打开一个新对话框，提示您解决 changelist 冲突。启用设置｜版本控制｜变更列表中的所有选项后可使用此文件状态。
#0A7700	已复制	如果某个文件是另一个文件的副本，其元数据将被追踪，并将该文件标记为已复制。
#616161	已删除	该文件已被计划从版本库中删除。
#773895	从文件系统中删除	该文件已在本地删除，但未被计划删除，并且仍存在于版本库中。
#8AA4C8	包含更改的子项	If a file is modified, the IDE will recursively highlight all directories containing that file. 启用在项目树中高亮显示包含已修改文件的目录选项并在设置｜版本控制｜确认设置后可使用此状态。
#3264B4	包含直接修改的子项	If a file is modified, the IDE will highlight its parent directory. 启用在项目树中高亮显示包含已修改文件的目录选项并在设置｜版本控制｜确认设置后可使用此状态。
#B28C00	被劫持	[Perforce、ClearCase、VSS] 文件为未签出情况下修改。
#727238	已忽略	该文件是被 VCS 有意忽略的未受控文件。
#7503DC	已合并	该文件由于更新已由 VCS 合并。
#FF0000	冲突合并	在最近一次更新过程中，该文件在合并时出现冲突。
#FF0000	属性冲突合并	在最近一次更新过程中，IDE 检测到本地文件与其服务器版本之间的属性存在差异。
#FF0000	文本和属性冲突合并	当两个或多个开发人员修改文件的相同行和相同的文件属性时，将发生文本和属性冲突。
#0032A0	已修改	该文件自上次同步后已发生更改。
#0047E4	在非活动 changelist 中修改	The file in an inactive changelist has been modified. 启用高亮显示非活动变更列表中的文件选项并在设置｜版本控制｜变更列表中设置后可使用此文件状态。
#7C7C00	已过时	该文件不应再存在于您的工作副本中。
#007C7C	已重命名	自上次更新以来，该文件已被重命名。
#08978F	已切换	[SVN] 文件来自与整个项目不同的分支。
#993300	（未知）未版本控制	该文件在本地存在，但并不在版本库中，也未被计划添加。
无（默认颜色）	最新	该文件未发生更改。

颜色	文件状态	说明
#629755	已添加	活动 changelist 中的文件已计划添加到版本库中。
#629755	已添加到非活动 changelist 中	The file in an inactive changelist is scheduled for addition to the repository. 启用高亮显示非活动变更列表中的文件选项后，在设置｜版本控制｜变更列表中将提供该文件状态。
#D5756C	changelist 冲突	非活动 changelist 中的文件已在活动 changelist 中被修改。在此情况下，将打开一个新对话框，引导您解决 changelist 冲突。启用设置｜版本控制｜变更列表中的所有选项后，该文件状态将可用。
#0A7700	已复制	如果某个文件是另一个文件的副本，则其元数据将被跟踪，并将此类文件标记为已复制。
#6C6C6C	已删除	该文件已计划从版本库中删除。
#6C6C6C	从文件系统中删除	该文件已在本地删除，但尚未计划删除，且仍存在于版本库中。
#6897BB	具有已更改的子项	If a file is modified, the IDE will recursively highlight all directories containing that file. 启用在项目树中高亮显示包含已修改文件的目录选项后，在设置｜版本控制｜确认中将提供此状态。
#6897BB	具有已更改的直接子项	If a file is modified, the IDE will highlight its parent directory. 启用在项目树中高亮显示包含已修改文件的目录选项后，在设置｜版本控制｜确认中将提供此状态。
无（默认颜色）	劫持	[Perforce、ClearCase、VSS] 此文件已被修改但未进行签出。
#848504	已忽略	该文件已被 VCS 有意忽略。
#9876AA	已合并	此文件已由 VCS 在更新操作中进行合并。
#D5756C	合并时存在冲突	在上次更新期间，文件在合并时发生冲突。
#D5756C	合并时属性冲突	在上次更新期间，IDE 检测到本地文件和服务器版本之间的属性存在差异。
#D5756C	合并时文本和属性冲突	当两个或更多开发人员修改同一文件的相同行和相同属性时，会发生文本与属性冲突。
#6897BB	已修改	该文件自上次同步后已发生更改。
#6897BB	在非活动 changelist 中已修改	The file in an inactive changelist has been modified. 启用高亮显示非活动变更列表中的文件选项后，在设置｜版本控制｜变更列表中将提供该文件状态。
无（默认颜色）	已废弃	该文件不应再存在于您的版本库工作副本中。
#3A8484	已重命名	自上次更新后，该文件已重命名。
无（默认颜色）	已切换	[SVN] 此文件来自不同于整个项目的分支。
#D1675A	（未知）未加入版本控制	该文件在本地存在，但不在版本库中，且未计划添加。
无（默认颜色）	已是最新	该文件未发生更改。

颜色	文件状态	说明
#62CC47	已添加	活动 changelist 中的文件已计划添加到版本库。
#62CC47	已添加（非活动 changelist）	处于非活动 changelist 中的文件已计划添加到版本库。启用高亮显示非活动变更列表中的文件选项并在设置｜版本控制｜变更列表中配置后，此文件状态可用。
#FF6666	changelist 冲突	非活动 changelist 中的文件在活动 changelist 中已被修改。在这种情况下，将打开一个新对话框，引导您解决 changelist conflict。启用设置｜版本控制｜变更列表中的所有选项后，此文件状态可用。
#62CC47	已复制	If a file is a copy of another file, its metadata is tracked, and such a file is marked as 已复制.
#ED864A	已删除	该文件已计划从版本库中删除。
#ED864A	从文件系统中删除	该文件已在本地被删除，但尚未计划删除，且仍存在于版本库中。
#4FF0FF	其下存在修改项	如果文件已被修改，IDE 将递归高亮显示包含该文件的所有目录。启用在项目树中高亮显示包含已修改文件的目录选项并在设置｜版本控制｜确认中配置后，此状态可用。
#4FF0FF	其直接子项已变更	如果文件已被修改，IDE 将高亮显示其父目录。启用在项目树中高亮显示包含已修改文件的目录选项并在设置｜版本控制｜确认中配置后，此状态可用。
无（默认颜色）	被篡改	[Perforce、ClearCase、VSS] 文件已在未检出状态下被修改。
#A9B837	已忽略	该文件被 VCS 有意不跟踪。
#ED94FF	已合并	该文件由 VCS 在更新过程中合并。
#FF6666	合并时有冲突	在上次更新期间，文件合并时发生冲突。
#FF6666	合并时有属性冲突	在上次更新期间，IDE 检测到本地文件属性与服务器版本存在差异。
#FF6666	合并时存在文本和属性冲突	当两位或多位开发人员同时修改文件中的相同行以及相同的文件属性时，会发生文本和属性冲突。
#4FF0FF	已修改	自上次同步以来，该文件已发生更改。
#4FF0FF	在非活动 changelist 中已修改	非活动 changelist 中的文件已被修改。启用高亮显示非活动变更列表中的文件选项并在设置｜版本控制｜变更列表中配置后，此文件状态可用。
无（默认颜色）	已废弃	该文件不应再包含在您工作副本中的版本库里。
#4FF0FF	已重命名	自上次更新以来，该文件已被重命名。
无（默认颜色）	已切换	[SVN] 文件来源于与整个项目不同的分支。
D1675A	（未知）未版本控制	该文件在本地存在，但不在版本库中，且未计划添加。
无（默认颜色）	最新	该文件未发生变化。

文件颜色

属于不同作用域（例如生产文件或测试文件）的文件可以在项目工具窗口、搜索结果和编辑器选项卡中以不同颜色高亮显示。

To each scope, you can assign its own color. 有关详细信息，请参阅将范围与颜色关联。

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