项目工具窗口

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

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

此外，视图包含临时文件和控制台文件夹，您可以通过它管理创建的草稿文件和扩展脚本。

视图

工具窗口有几个视图：

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

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

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

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

外观和行为

快速添加文件和文件夹

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

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

预览文件

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

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

显示文件大小和修改时间

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

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

显示树缩进指南

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

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

点击一次即可打开文件

您可以配置项目工具窗口，使其通过点击即可在编辑器中打开文件。

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

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

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

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

标题上下文菜单

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

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

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

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

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

条目	快捷键	描述
新	`Alt+Insert`	在选定项（目录、文件或类）内创建一个新项。（项目或目录）。
剪切	`Ctrl+X`	将选定的项目从当前位置移动到剪贴板。
复制(C)	`Ctrl+C`	将选定的项目复制到剪贴板。
复制路径/引用		请使用此命令和以下选项之一将选定项复制到剪贴板：绝对路径：复制所选项目或项目的完整路径。文件名：仅将文件名复制到剪贴板。来自内容根的路径：复制相对于包含应用程序内容文件的目录的路径。来自源根的路径：复制相对于源根的路径。仓库根路径：复制相对于项目存储库的路径。 GitHub 仓库 URL ：复制 GitHub 上项目仓库的相对路径。工具箱URL ：如果您安装了 WebStorm Toolbox，您可以将复制的路径插入到浏览器中，以选择的项目打开 Toolbox 应用程序。复制引用(Y) (`Ctrl+Alt+Shift+C` )：复制所选项目的引用，包括行号。
粘贴	`Ctrl+V`	将剪贴板内容插入到选定位置。
查找用法	`Alt+F7`	搜索所选项目的用法。（查找用法对话框将会打开。）
在文件中查找	`Ctrl+Shift+F`	执行文本搜索。（将打开在文件中查找对话框。）
在文件中替换	`Ctrl+Shift+R`	执行文本查找和替换。 (在路径中替换对话框将打开。)
检查代码		使用此命令对选定项目运行代码检查。
重命名	`Shift+F6`	重命名选定项目。
重构		对选定项目执行可用的重构操作之一。
书签		将选定项目添加到现有或新的书签列表。
重新设置代码格式	`Ctrl+Alt+L`	将选定文件或当前目录中所有文件的源代码重新格式化。另请参阅重新设置代码格式。
优化 import	`Ctrl+Alt+O`	在所选文件或当前目录中的所有文件中优化 import。此功能会移除未使用的导入并重新排列导入语句。
Delete	`Delete`	删除所选项目。请谨慎使用！
覆盖文件类型		更改所选文件的类型，例如，将其更改为纯文本以将其从项目中排除，这样它将不被检查、代码补全、导航等处理。文件会用一个特殊图标标识，并在编辑器中显示为纯文本。更多信息，请参见排除文件。
运行“<item_name>”	`Ctrl+Shift+F10`	使用默认配置设置运行选定文件。
调试 '<item_name>'	`⌃ ⇧ D`	使用默认配置设置调试选定文件。
更多运行/调试		修改运行配置：打开创建/编辑运行配置对话框并更新默认配置设置。运行 '<item_name>' 并覆盖：从选定文件运行测试并根据默认设置测量代码覆盖率。此项目仅在测试文件的上下文菜单中可用。
在右侧分屏中打开	`Shift+Enter`	将编辑器分为两部分，并在右侧区域显示该文件。有关更多信息，请参阅分屏。
打开		访达 - 在系统文件管理器中打开选定项目。在关联的应用程序中打开 - 在其本机应用程序中打开选定项目。路径弹出窗口 - 打开一个弹出窗口，显示选定项目的路径。终端 - 在内置终端中打开选定项目所在的目录。
本地历史记录		查看选定文件或目录的本地历史记录，或者为您的当前版本创建标签项目。
文件菜单中的修复 IDE		修复与文件相关的缓存，了解更多信息请参阅修复 IDE。
从磁盘重新加载		将工具窗口中的视图与文件系统中保存的视图同步。如果您在外部更改文件或目录内容，在某些情况下，WebStorm 可能不会意识到相应的更改，除非您使用此命令。
比较对象	`Ctrl+D`	将所选文件或目录与另一个文件或目录进行比较。请参见比较文件、文件夹和文本来源和文件夹差异查看器。
与编辑器比较文件		将所选文件与活动编辑器选项卡中打开的文件进行比较。请参阅比较文件、文件夹和文本来源和文件差异查看器。
外部工具		启动一个第三方工具。
将目录标记为		将选定的目录设为源根目录或测试源根目录，或将目录排除等。从子菜单中选择目录所需的类别。
部署		根据部署配置将所选项上传到服务器，或从服务器下载文件，与已上传的版本进行比较并同步。有关更多信息，请参阅部署您的应用程序。文件和文件夹
图表	""" `Ctrl+Alt+Shift+U` 或 `Ctrl+Alt+U` """	为选定项打开一个图（例如，一个 UML 图）。
创建 Gist		使用此命令通过 gists 分享代码。

文件状态高亮

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

您可以在版本控制 | 文件状态颜色设置页面  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	（未知）无版本	该文件在本地存在，但不在代码库中，也未被安排添加。
无（默认颜色）	最新	该文件未被更改。

文件颜色

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

您可以为每个范围分配其自己的颜色。有关更多信息，请参见将范围与颜色关联。

最后修改日期： 2025年 12月 8日