NPM 工具窗口

开始之前

当您在 Project 工具窗口 Alt+1 中选择 package.json 文件或在编辑器中打开它并从上下文菜单中选择显示 npm 脚本时， npm 工具窗口会打开。

您一旦调用 npm、pnpm 或 Yarn，该工具就会开始构建一个在 scripts 属性中定义的脚本树，并且是在调用它的 package.json 文件上构建。

如果在项目中有多个 package.json 文件，您可以为每个文件构建一个单独的脚本树，并在不删除先前构建的树的情况下运行脚本。每棵树显示在一个单独的节点下。

工具窗口显示脚本输出，报告发生的错误，列出未找到的软件包或插件等。最后执行的脚本名称显示在工具窗口的标题栏上。

在 Project 工具窗口 Alt+1 中选择所需的 package.json 文件，或在编辑器中打开它，然后从上下文菜单中选择显示 npm 脚本。
在 npm 工具窗口中，点击工具栏，然后从列表中选择所需的 package.json 文件。默认情况下，PhpStorm 会在项目的根目录中显示 package.json 文件。如果您有另一个 package.json 文件，请点击选择 package.json 并在打开的对话框中选择所需的 package.json 文件。 PhpStorm 添加一个新节点，其标题中包含所选 package.json 文件的路径，并在新节点下构建脚本树。

使用多选模式：按住 Shift （用于相邻的项目）或 Ctrl （用于非相邻的项目）键并选择所需的脚本，然后从选择的上下文菜单中选择运行或 Debug。

	添加 package.json	点击此按钮以生成另一个 package.json 文件的脚本树。从列表中选择所需的 package.json 文件。 PhpStorm 添加了一个新节点并在其下构建了一个脚本树。
	删除 package.json	点击此按钮以删除选定节点下的脚本树。
	重新加载脚本	点击此按钮，以重新构建选定节点下的脚本树。更新相应的 package.json 文件后，您可能需要重新构建树，因为 npm 不会即时应用更改到树上。
	全部折叠	点击此按钮以隐藏所有脚本树并仅显示 package.json 节点。
		点击此按钮以配置当前视图并更改工具窗口的查看模式。更多信息，请参见工具窗口视图模式。请注意，大多数菜单项是可以开启或关闭的选项。一个选项打开时，在其名称左侧有一个复选标记。 npm 特定选项如下：编辑 npm 配置：选择此选项以打开 npm Run/Debug Configuration dialog ，并更新当前的 npm 和 Node interpreter 设置，请参阅 npm、pnpm and Yarn。排序方式：选择此选项以配置脚本在树状结构中的显示顺序。点击工具栏上的按钮，从菜单中选择排序方式，然后选择名称。默认情况下，树会按在 package.json 中定义的顺序显示脚本（选项定义顺序）。
	隐藏	点击此按钮以隐藏工具窗口。若要再次显示它，请在主菜单中选择视图 \| 工具窗口 \| npm。工具窗口再次出现，显示所有先前构建的任务树。

npm 设置	选择此菜单项以打开 npm 设置对话框并查看或编辑 Node.js配置
跳转到源	选择此菜单项以打开当前树构建的 package.json 文件。
重新加载脚本	选择此菜单项以重新构建所选节点下的脚本树。
复制路径	选择此菜单项以将构建当前树的 package.json 文件路径保存到剪贴板。
删除 package.json	选择此菜单项以移除所选节点下的脚本树。

运行 <script name>	选择此菜单项以运行选定的脚本。
编辑<script name>设置	选择此菜单项以打开运行/调试配置对话框并编辑所选脚本的预定义设置。
跳转到源	选择此菜单项以打开 package.json 文件，当前树为其构建，并导航到所选脚本的定义。

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