项目工具窗口

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

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

此外，该视图包含草稿与控制台文件夹，可用于管理已创建的临时文件与扩展脚本。

视图

该工具窗口提供以下几种视图：

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

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

您也可以将每个视图显示在单独的标签页中：单击并关闭标签页分组选项。

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

外观与行为

快速添加文件和文件夹

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

单击工具窗口工具栏中的，然后从列表中选择一个选项。
使用快速查找以更快找到选项：开始输入要创建的文件类型，从而缩小结果范围。

预览文件

可以通过以下两种方式预览文件，而无需为每个文件打开一个单独的标签页：

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

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

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

在项目工具窗口 Alt+1 中，单击并选择外观 | 文件详情。

显示树缩进引导线

在项目工具窗口中，您可以显示垂直线来标记缩进级别，从而帮助更好地理解项目中各组件的层级关系。

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

单击一次即可打开文件

您可以配置项目工具窗口以单击一次即可在编辑器中打开文件。

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

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

WebStorm 可帮助您跟踪当前在活动编辑器标签中打开的文件，并自动在项目工具窗口中选中该文件。

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

标题栏上下文菜单

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

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

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

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

项目的上下文菜单提供对此项目所有可用功能的访问。

项目	快捷键	说明
新建	`Alt+Insert`	在所选项中创建一个新项目（目录、文件或类）。（项目或目录）。
剪切	`Ctrl+X`	将所选项目从当前位置移至剪贴板。
复制(C)	`Ctrl+C`	将所选项目复制到剪贴板。
复制路径/引用		使用此命令和以下其中一项选项将所选项目复制到剪贴板：绝对路径：复制所选项目的完整路径。文件名：仅将文件名复制到剪贴板。来自内容根的路径：复制相对于包含应用程序内容文件的目录的路径。来自源根的路径：复制相对于 Sources Root 的路径。仓库根路径：复制相对于项目代码库的路径。 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`	重新格式化所选文件或当前目录中所有文件的源代码。另请参见重新格式化并重新排列代码。
优化导入	`Ctrl+Alt+O`	优化所选文件或当前目录中所有文件的导入。此功能会移除未使用的导入并重新排列导入语句。
删除	`Delete`	删除所选项。请谨慎操作！请谨慎操作！
覆盖文件类型		更改所选文件的类型，例如更改为纯文本，以将其从项目中排除，从而使其不会被检查、代码补全、导航等功能处理。文件将使用特殊图标标识，并在编辑器中作为纯文本显示。如需了解更多信息，请参阅排除文件。
运行“<item_name>”	`Ctrl+Shift+F10`	使用默认配置设置运行所选文件。
调试“<item_name>”	`⌃ ⇧ D`	使用默认配置设置调试所选文件。
更多运行/调试选项		修改运行配置：打开创建／编辑运行配置对话框并更新默认配置设置。使用覆盖率运行“<item_name>” ：运行所选文件中的测试，并根据默认设置测量代码覆盖率。此项仅在测试文件的上下文菜单中可用。
在右侧拆分中打开	`Shift+Enter`	将编辑器拆分为两部分，并在右侧区域显示该文件。如需了解更多信息，请参阅拆分屏幕。
打开方式		Finder - 在系统文件管理器中打开所选项。在关联应用中打开 - 在其原生应用程序中打开所选项。路径弹出窗口 - 打开一个弹出窗口，显示所选项的路径。终端 - 在内置终端中打开所选项所在的目录。
本地历史记录		查看所选文件或目录的本地历史记录，或者为当前版本的项目创建标签。
修复文件相关 IDE 问题		修复与文件相关的缓存，了解详情请参阅修复 IDE。
从磁盘重新加载		将工具窗口中的视图与文件系统中保存的视图同步。如果您在外部更改了文件或目录内容，在某些情况下，WebStorm 可能不会察觉相应的更改，除非使用此命令。
对比	`Ctrl+D`	将所选文件或目录与另一个文件或目录进行比较。请参阅比较文件、文件夹与文本源和文件夹差异查看器。
与编辑器中的文件对比		将所选文件与活动编辑器标签中打开的文件进行比较。请参阅比较文件、文件夹与文本源和文件差异查看器。
外部工具		启动第三方工具。
标记为目录		将所选目录标记为源代码根目录或测试源代码根目录，或将目录排除等。需要的目录类别可从子菜单中选择。
部署		根据部署配置将所选项上传到服务器，或从服务器下载文件，与已上传的版本进行比较并同步。详细了解请参阅部署您的应用。文件与文件夹
图表	`Ctrl+Alt+Shift+U` 或 `Ctrl+Alt+U`	打开所选项的图表（例如 UML 图）。
创建 Gist		使用此命令通过 Gist 共享代码。

文件状态高亮

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

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

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

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

颜色	文件状态	说明
#629755	已添加	活动的 changelist 中的文件已计划加入版本库。
#629755	在非活动 changelist 中添加	非活动更改列表中的文件已计划添加到存储库。若在突出显示非活动变更列表中的文件中启用了设置 \| 版本控制 \| 变更列表选项，则此文件状态可用。
#D5756C	changelist 冲突	非活动 changelist 中的文件在活动 changelist 中已被修改。在此情况下，将打开一个新对话框，提示您解决 changelist conflict。仅当在设置 \| 版本控制 \| 变更列表中启用了所有选项，此文件状态才可用。
#0A7700	已复制	若某个文件是另一个文件的副本，则会跟踪其元数据，并将该文件标记为已复制。
#6C6C6C	已删除	该文件已计划从版本库中删除。
#6C6C6C	从文件系统中删除	该文件已在本地删除但尚未计划删除，同时仍在版本库中存在。
#6897BB	包含已更改的子项	如果某个文件被修改，IDE 将递归高亮包含该文件的所有目录。仅当在在项目树中突出显示包含已修改文件的目录中启用设置 \| 版本控制 \| 确认选项时，此状态可用。
#6897BB	直接子项已更改	如果某个文件被修改，IDE 将高亮其父目录。仅当在在项目树中突出显示包含已修改文件的目录中启用了设置 \| 版本控制 \| 确认选项，此状态才可用。
无（默认颜色）	被占用	[Perforce、ClearCase、VSS] 文件已在未检出情况下被修改。
#848504	已忽略	该文件被 VCS 有意忽略而不进行跟踪。
#9876AA	已合并	该文件由于更新已由 VCS 合并。
#D5756C	合并时存在冲突	在上次更新期间，该文件在合并时出现了冲突。
#D5756C	合并时存在属性冲突	在上次更新期间，IDE 检测到本地文件与服务器版本的属性之间存在差异。
#D5756C	合并时存在文本和属性冲突	当两个或多个开发者修改文件相同行及相同文件属性时，将发生文本和属性冲突。
#6897BB	已修改	自上次同步以来，该文件已被更改。
#6897BB	在非活动 changelist 中已修改	非活动更改列表中的文件已被修改。若在突出显示非活动变更列表中的文件中启用了设置 \| 版本控制 \| 变更列表选项，则此文件状态可用。
无（默认颜色）	已废弃	该文件不应再出现在版本库的工作副本中。
#3A8484	已重命名	自上次更新以来，文件名称已更改。
无（默认颜色）	已切换	[SVN] 该文件来自与整个项目不同的分支。
#D1675A	（未知）未纳入版本控制	该文件在本地存在，但不在版本库中，且未计划添加。
无（默认颜色）	最新	该文件未被修改。

颜色	文件状态	说明
#62CC47	已添加	活动的 changelist 中的文件已计划添加至版本库。
#62CC47	已在非活动 changelist 中添加	非活动 changelist 中的文件已计划添加至版本库。启用突出显示非活动变更列表中的文件选项后，该文件状态可用，位置为设置 \| 版本控制 \| 变更列表。
#FF6666	changelist 冲突	非活动 changelist 中的文件在活动 changelist 中已被修改。此时将打开新对话框，提示您解决 changelist 冲突。此文件状态仅在设置 \| 版本控制 \| 变更列表中启用所有选项时可用。
#62CC47	已复制	如果某文件是另一文件的副本，其元数据将被跟踪，并标记为已复制。
#ED864A	已删除	此文件已计划从版本库中删除。
#ED864A	已从文件系统中删除	此文件在本地已删除，但尚未计划删除，版本库中仍存在。
#4FF0FF	包含已更改的子项	如果文件被修改，IDE 将递归地高亮显示包含该文件的所有目录。启用在项目树中突出显示包含已修改文件的目录选项后，该状态在设置 \| 版本控制 \| 确认中可用。
#4FF0FF	包含直接更改的子项	如果文件被修改，IDE 将高亮其父目录。启用在项目树中突出显示包含已修改文件的目录选项后，该状态在设置 \| 版本控制 \| 确认中可用。
无（默认颜色）	已劫持	【Perforce、ClearCase、VSS】该文件被修改但未签出。
#A9B837	已忽略	该文件被 VCS 有意忽略。
#ED94FF	已合并	此文件已在更新过程中由 VCS 合并。
#FF6666	合并时存在冲突	在上次更新期间，文件在合并时存在冲突。
#FF6666	合并时存在属性冲突	在上次更新期间，IDE 检测到本地文件属性与服务器版本之间存在差异。
#FF6666	合并时存在文本和属性冲突	当两个或多个开发者修改文件相同行以及相同属性时，会发生文本和属性冲突。
#4FF0FF	已修改	该文件自上次同步以来已发生更改。
#4FF0FF	在非活动 changelist 中已修改	非活动 changelist 中的文件已被修改。启用突出显示非活动变更列表中的文件选项后，该文件状态在设置 \| 版本控制 \| 变更列表中可用。
无（默认颜色）	已废弃	该文件不应再出现在您的版本库工作副本中。
#4FF0FF	已重命名	自上次更新以来，文件已被重命名。
无（默认颜色）	已切换	[SVN] 此文件来自与整个项目不同的分支。
D1675A	（未知）未加入版本控制	该文件仅存在于本地，不在版本库中，也未计划添加。
无（默认颜色）	是最新的	该文件未发生更改。

文件颜色

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

您可以为每个作用域分配其专属颜色。有关详细信息，请参阅将范围与颜色关联。

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