项目工具窗口

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

此工具窗口中的大多数功能可以通过内容窗格中的上下文菜单命令和相关快捷键访问。

该视图还包含临时文件与控制台文件夹，您可以在其中管理创建的临时文件、查询控制台和扩展脚本。

视图

工具窗口有几个视图：

Project 视图。此视图显示所有 project 项目及其依赖项（解释器和库）。重点在于目录结构，包也有所展示。
范围视图（项目文件、打开文件等）。这些视图显示了预定义和用户定义的 scopes的内容。在其他方面，根据当前选择的视图选项，范围视图可能类似于 Project 或 Packages 视图。

要在视图之间切换，请按 Alt+Right/Alt+Left 或从标题上的列表中选择一个视图。

您还可以在单独的选项卡中显示每个视图：点击并禁用标签页分组选项。

要配置视图，请使用标题上下文菜单中的相应选项。也可以通过单击标题上的来访问所需选项。

外观和行为

快速添加文件和文件夹

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

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

预览文件

有两种方法无需在单独的选项卡中打开文件即可预览：

使用文件预览弹出窗口：在 Project 工具窗口 Alt+1 中选择一个文件并按 Space。
启用预览选项卡：单击并选择行为｜启用预览标签页。

显示文件大小和修改时间

您可以查看 project 树中文件的大小和修改时间戳。

在 Project 工具窗口 Alt+1 中，单击并选择外观 | 文件详细信息。

显示树形缩进指南

在 Project 工具窗口中，您可以显示标记缩进级别的垂直线，以帮助您更好地理解 project 中组件的层次结构。

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

标题上下文菜单

通过右键单击标题或单击选项按钮出现的上下文菜单提供 project 视图、查看模式的设置，以及在视图之间切换、调整工具窗口大小等功能。

下表列出了可用的命令和选项，并进行了简要说明。

项目	快捷键	描述
行为
启用预览标签页		启用预览选项卡，允许您在单个选项卡中逐个查看文件，而无需为每个文件打开一个新选项卡。
一键打开文件		通过单击 Project 工具窗口中的项目，在编辑器中打开该项目。否则，您需要双击项目才能打开它们。请注意，如果启用了预览选项卡，则无法禁用此选项。
单击打开目录		通过单击 Project 工具窗口中的目录，可以展开和折叠目录。否则，您需要双击目录以将其打开，或者使用目录名称旁边的图标。
始终选择打开的文件		如果此选项开启，RubyMine 将自动定位您在编辑器中打开的文档到此窗口的当前视图中。
Appearance
成员		如果开启此选项，包含类的树中的文件将变为节点。当这样的节点展开时，将显示所选项目的包含类及其字段、方法和其他成员。
排除的文件		仅在项目视图中提供此选项。将此选项打开或关闭以显示或隐藏排除的文件夹和文件。
临时文件与控制台		隐藏或显示临时文件与控制台节点。这个节点包含您的临时文件和查询控制台。
文件详情		选择此选项以显示文件的大小和修改时间戳。
文件嵌套		打开文件嵌套对话框，您可以在其中配置同名不同扩展名文件的显示方式。
自定义树视图		请导航至设置 \| 外观与行为 \| 外观 \| 树视图配置树视图选项。
排序方式
名称		按文件名称字母顺序排序。该选项不会影响文件夹的顺序，它们始终按字母顺序排序。
Type		按文件扩展名排序。该选项不会影响文件夹的顺序，它们始终按字母顺序排序。
修改时间（最新优先/最旧优先）		按文件修改时间排序。要显示此信息，请从主菜单中选择视图 \| 外观 \| 树状视图中的详细信息。该选项不会影响文件夹的顺序，它们始终按字母顺序排序。
文件夹总在最前		如果该选项开启，文件夹将显示在文件上方。否则，所有项目按字母顺序排序，文件和文件夹会混在一起显示。
编辑范围		打开范围对话框，您可以在其中创建和编辑用户定义的范围。请注意，此命令仅在当前视图为 scope 视图时可用。
快速搜索	`Ctrl+F`	搜索项目。了解更多工具窗口中的 Speed Search
标签页分组		如果启用此选项，标题左侧会有一个列表，您可以从中选择所需的视图。如果禁用此选项，视图将以选项卡的形式显示在标题的左侧。
视图模式		此选项允许您控制工具窗口的一般外观与行为。有关完整信息，请参阅工具窗口查看模式。
移至		要将工具窗口与不同的工具窗口栏关联起来，请选择此命令，然后选择目标工具窗口栏（顶部、左侧、底部或右侧）。有关完整信息，请参考移动工具窗口章节。
调整大小		要通过移动工具窗口的某个边界来调整其大小，请选择此命令，然后选择必要的延展至选项。请注意，此命令在浮动模式下不可用。
从边栏中移除		此命令隐藏工具窗口，从工具窗口栏中移除关联的工具窗口按钮，并从快速访问菜单（或）中移除工具窗口。要重新打开工具窗口（并恢复相关功能），请使用主菜单： """ 视图 \| 工具窗口 \| <Window Name> """ 或按 `Alt+1`。
帮助		此命令在 RubyMine 在线帮助中打开 Project 工具窗口的描述。

标题栏操作

项目	快捷键	描述
		从编辑器中的文件导航到 Project 工具窗口 `Alt+1` 中的相应节点（文件、类、字段、方法等）。如果当前启用了始终选择已打开的文件选项，则此图标不可用。
	`Ctrl+NumPad +`	展开所有节点。
	`Ctrl+NumPad -`	折叠所有节点。
		打开菜单以配置当前视图并更改工具窗口的查看模式。可用选项是标题上下文菜单项目的子集。请注意，大多数菜单项是可以开启或关闭的选项。一个选项打开时，在其名称左侧有一个复选标记。编辑范围显示成员单击打开文件始终选择已打开的文件按类型排序文件夹始终在顶部显示排除的文件固定模式、停靠模式、浮动模式、窗口模式、拆分模式从侧边栏移除分组选项卡移动到调整大小
	`Shift+Escape`	隐藏工具窗口 `Shift+Escape`。要隐藏所有工具窗口，请按 `Ctrl+Shift+F12`。

内容窗格

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

以下表格中显示并简要说明了主要类别（节点类型）的图标。用于主要符号（类、字段、方法等）的图标显示在图标参考。

项目	描述
	模块
	包
	文件夹（目录）。不同的文件夹类别有不同的颜色。目录测试源文件夹
	外部库，用于分组与 project 相关的第三方软件的类别。仅当选择了 Project 视图时才显示该节点。

项目窗格中内容项的上下文菜单命令

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

项目	快捷键	描述
新建	`Alt+Insert`	在选定项目内创建新项目（目录、文件或类）。（project 或目录）。
剪切	`Ctrl+X`	将选定的项目从当前位置移动到剪贴板。
复制(C)	`Ctrl+C`	将选定的项目复制到剪贴板。
复制路径/引用		请使用此命令和以下选项之一将选定项复制到剪贴板：绝对路径：复制所选项目或项目的完整路径。文件名：仅将文件名复制到剪贴板。来自内容根的路径：复制相对于包含应用程序内容文件的目录的路径。来自源根的路径：复制相对于源根的路径。仓库根路径：复制相对于项目存储库的路径。 GitHub 仓库 URL ：复制 GitHub 上项目仓库的相对路径。工具箱URL ：如果您安装了 RubyMine 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`	将编辑器分成两部分，并在右侧部分显示文件。欲了解更多信息，请参阅分屏。
打开		在系统的文件管理器或终端中打开文件。
本地历史记录		查看选定文件或目录的本地历史记录，或者为您的当前版本创建标签 project。
同步 '<item_name>'		将工具窗口中的视图与文件系统中保存的视图同步。如果您在外部更改文件或目录内容，在某些情况下，RubyMine 可能不会意识到相应的更改，除非您使用此命令。
比较	`Ctrl+D`	将选定的文件或目录与另一个文件或目录进行比较。请参阅比较文件、文件夹和文本来源。
与编辑器中的文件比较		将选定文件与在活动编辑器选项卡中打开的文件进行比较。参见比较文件、文件夹和文本来源。
外部工具		启动一个第三方工具。
标记目录为		将选定目录设置为源根目录或测试源根目录，或将目录排除等。从子菜单中选择目录所需的类别。
图表	`Ctrl+Alt+Shift+U` 或 `Ctrl+Alt+U`	为选定项打开一个图（例如，一个 UML 图）。

文件状态高亮

如果当前 project 启用了 VCS 集成，RubyMine 会使用颜色标注 VCS 文件状态在 Project 工具窗口中。

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

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

颜色	文件状态	描述
#0A7700	新增	处于活动 changelist 中的文件已计划添加到存储库。
#0EAA00	添加到非活动变更列表	该文件在未激活的变更列表中已安排添加到存储库。若在突出显示未激活变更列表中的文件选项中启用了设置 \| 版本控制 \| Changelists ，则文件状态可用。
#FF0000	变更列表冲突	在非活动更改列表中的文件已在活动更改列表中被修改。在这种情况下，将会打开一个新对话框，提示您解决 changelist conflict。如果在设置 \| 版本控制 \| Changelists 中启用所有选项，则此文件状态可用。
#0A7700	复制	如果文件是另一文件的副本，则会跟踪其元数据，并将此类文件标记为已复制。
#616161	已删除	该文件已被安排从存储库中删除。
#773895	从文件系统中删除	该文件已在本地删除，但尚未被安排删除，仍然存在于存储库中。
#8AA4C8	有更改的后代项	如果文件被修改，IDE 将递归高亮包含该文件的所有目录。如果在在项目树中高亮显示包含已修改文件的目录中启用了设置 \| 版本控制 \| 确认选项，则此状态可用。
#3264B4	有立即更改的子项	如果文件被修改，IDE 会高亮显示其父目录。如果在在项目树中高亮显示包含已修改文件的目录中启用了设置 \| 版本控制 \| 确认选项，则此状态可用。
#B28C00	劫持	[Perforce，ClearCase，VSS] 文件未签出已被修改。
#727238	忽略	文件被故意排除在 VCS 跟踪之外。
#7503DC	已合并	“文件已被您的 VCS 因更新而合并。”
#FF0000	合并冲突	在上次更新期间，文件已合并并存在冲突。
#FF0000	合并时发生属性冲突	在上次更新期间，IDE 检测到本地文件与其服务器版本的属性之间存在差异。
#FF0000	文本和属性冲突合并	当两个或多个开发人员修改文件的相同行和相同的文件属性时，就会发生文本和属性冲突。
#0032A0	已修改	该文件自上次同步以来已更改。
#0047E4	在非活动变更列表中修改	已修改的文件处于非活动变更列表中。若在突出显示未激活变更列表中的文件选项中启用了设置 \| 版本控制 \| Changelists ，则文件状态可用。
#7C7C00	已过时	该文件不应再位于您的仓库工作副本中。
#007C7C	重命名	自上次更新以来，该文件已重命名。
#08978F	切换	[SVN] 文件来自与整个项目不同的分支。
#993300	（未知）无版本	该文件在本地存在，但不在代码库中，也未被安排添加。
无（默认颜色）	最新	该文件未被更改。

颜色	文件状态	描述
#629755	新增	处于活动 changelist 中的文件已计划添加到存储库。
#629755	添加到非活动变更列表	该文件在未激活的变更列表中已安排添加到存储库。若在突出显示未激活变更列表中的文件选项中启用了设置 \| 版本控制 \| Changelists ，则文件状态可用。
# D5756C	变更列表冲突	在非活动更改列表中的文件已在活动更改列表中被修改。在这种情况下，将会打开一个新对话框，提示您解决 changelist conflict。如果在设置 \| 版本控制 \| Changelists 中启用所有选项，则此文件状态可用。
#0A7700	复制	如果文件是另一文件的副本，则会跟踪其元数据，并将此类文件标记为已复制。
#6C6C6C	已删除	该文件已被安排从存储库中删除。
#6C6C6C	从文件系统中删除	该文件已在本地删除，但尚未被安排删除，仍然存在于存储库中。
#6897BB	有更改的后代项	如果文件被修改，IDE 将递归高亮包含该文件的所有目录。如果在在项目树中高亮显示包含已修改文件的目录中启用了设置 \| 版本控制 \| 确认选项，则此状态可用。
#6897BB	有立即更改的子项	如果文件被修改，IDE 会高亮显示其父目录。如果在在项目树中高亮显示包含已修改文件的目录中启用了设置 \| 版本控制 \| 确认选项，则此状态可用。
无（默认颜色）	劫持	[Perforce，ClearCase，VSS] 文件未签出已被修改。
#848504	忽略	文件被故意排除在 VCS 跟踪之外。
#9876AA	已合并	“文件已被您的 VCS 因更新而合并。”
# D5756C	合并冲突	在上次更新期间，文件已合并并存在冲突。
# D5756C	合并时发生属性冲突	在上次更新期间，IDE 检测到本地文件与其服务器版本的属性之间存在差异。
# D5756C	文本和属性冲突合并	当两个或多个开发人员修改文件的相同行和相同的文件属性时，就会发生文本和属性冲突。
#6897BB	已修改	该文件自上次同步以来已更改。
#6897BB	在非活动变更列表中修改	已修改的文件处于非活动变更列表中。若在突出显示未激活变更列表中的文件选项中启用了设置 \| 版本控制 \| Changelists ，则文件状态可用。
无（默认颜色）	已过时	该文件不应再位于您的仓库工作副本中。
#3A8484	重命名	自上次更新以来，该文件已重命名。
无（默认颜色）	切换	[SVN] 文件来自与整个项目不同的分支。
#D1675A	（未知）无版本	该文件在本地存在，但不在代码库中，也未被安排添加。
无（默认颜色）	最新	该文件未被更改。

颜色	文件状态	描述
#62CC47	新增	处于活动 changelist 中的文件已计划添加到存储库。
#62CC47	添加到非活动变更列表	该文件在未激活的变更列表中已安排添加到存储库。若在突出显示未激活变更列表中的文件选项中启用了设置 \| 版本控制 \| Changelists ，则文件状态可用。
#FF6666	变更列表冲突	在非活动更改列表中的文件已在活动更改列表中被修改。在这种情况下，将会打开一个新对话框，提示您解决 changelist conflict。如果在设置 \| 版本控制 \| Changelists 中启用所有选项，则此文件状态可用。
#62CC47	复制	如果文件是另一文件的副本，则会跟踪其元数据，并将此类文件标记为已复制。
#ED864A	已删除	该文件已被安排从存储库中删除。
#ED864A	从文件系统中删除	该文件已在本地删除，但尚未被安排删除，仍然存在于存储库中。
#4FF0FF	有更改的后代项	如果文件被修改，IDE 将递归高亮包含该文件的所有目录。如果在在项目树中高亮显示包含已修改文件的目录中启用了设置 \| 版本控制 \| 确认选项，则此状态可用。
#4FF0FF	有立即更改的子项	如果文件被修改，IDE 会高亮显示其父目录。如果在在项目树中高亮显示包含已修改文件的目录中启用了设置 \| 版本控制 \| 确认选项，则此状态可用。
无（默认颜色）	劫持	[Perforce，ClearCase，VSS] 文件未签出已被修改。
#A9B837	忽略	文件被故意排除在 VCS 跟踪之外。
#ED94FF	已合并	“文件已被您的 VCS 因更新而合并。”
#FF6666	合并冲突	在上次更新期间，文件已合并并存在冲突。
#FF6666	合并时发生属性冲突	在上次更新期间，IDE 检测到本地文件与其服务器版本的属性之间存在差异。
#FF6666	文本和属性冲突合并	当两个或多个开发人员修改文件的相同行和相同的文件属性时，就会发生文本和属性冲突。
#4FF0FF	已修改	该文件自上次同步以来已更改。
#4FF0FF	在非活动变更列表中修改	已修改的文件处于非活动变更列表中。若在突出显示未激活变更列表中的文件选项中启用了设置 \| 版本控制 \| Changelists ，则文件状态可用。
无（默认颜色）	已过时	该文件不应再位于您的仓库工作副本中。
#4FF0FF	重命名	自上次更新以来，该文件已重命名。
无（默认颜色）	切换	[SVN] 文件来自与整个项目不同的分支。
D1675A	（未知）无版本	该文件在本地存在，但不在代码库中，也未被安排添加。
无（默认颜色）	最新	该文件未被更改。

文件颜色

属于不同范围（例如生产文件或测试文件）的文件可以在 Project 工具窗口、搜索结果和编辑器选项卡中以不同颜色突出显示。

对每个作用域，您可以分配其自己的颜色。欲了解更多信息，请参阅将范围与颜色关联。

最后修改日期： 2025年 7月 22日