项目工具窗口

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

该视图还包含临时文件与控制台文件夹，允许您管理创建的 scratch files、查询控制台和扩展脚本。

视图

工具窗口有几个视图：

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

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

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

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

外观和行为

快速添加文件和文件夹

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

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

预览文件

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

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

显示文件大小和修改时间

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

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

显示树缩进指南

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

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

单击一次打开文件

您可以配置 Project 工具窗口，在编辑器中通过单击文件即可打开。

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

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

PhpStorm 可通过在 Project 工具窗口中自动选中当前在活动编辑器选项卡中打开的文件，帮助您跟踪该文件。

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

标题上下文菜单

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

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

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

标题栏操作

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

内容窗格

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

以下表格中显示并简要说明了主要类别（节点类型）的图标。主要符号（类、字段、方法等）、可见性修饰符和书签使用的图标显示在图标参考中。

项目	描述
	文件夹（目录）。不同类别的文件夹有不同的颜色。目录源文件夹测试源文件夹排除的文件夹
	在外部库节点下，PhpStorm 列出了加载的捆绑 PHP 存根和第三方文件（库），其函数和方法被添加到 PhpStorm 的内部知识中以增强编码辅助功能。如需更多信息，请参阅配置 include paths 和配置 JavaScript 库。
	您的临时文件和控制台被分组在此节点下。
	标记为纯文本的文件。

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

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

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

文件状态高亮

如果当前 project 启用了 VCS 集成，PhpStorm 会使用颜色标注 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年 9月 26日