npm 工具窗口

开始之前

当您在项目工具窗口 Alt+1 中选择一个 package.json 文件，或在编辑器中将其打开并在上下文菜单中选择显示 npm 脚本时，将打开 npm 工具窗口。

一旦您调用 npm、pnpm 或 Yarn，该工具就会开始根据调用所在的 package.json 文件中 scripts 属性定义的内容构建脚本树。

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

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

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

	添加 package.json	点击此按钮可为另一个 package.json 文件构建脚本树。在列表中选择所需的 package.json 文件。 PyCharm 会添加一个新节点，并在其下构建脚本树。
	移除 package.json	点击此按钮以移除所选节点下的脚本树。
	重新加载脚本	点击此按钮可在所选节点下重新构建脚本树。您可能需要在更新相应的 package.json 文件后重新构建树，因为 npm 不会即时将更改应用到树。
	全部折叠	点击此按钮以隐藏所有的脚本树，并仅显示 package.json 节点。
		点击此按钮以配置当前视图，并更改工具窗口的查看模式。有关详细信息，请参阅工具窗口视图模式。请注意，大多数菜单项是可以打开或关闭的选项。已启用的选项在其名称左侧带有复选标记。 npm 特定的选项包括：编辑 npm 配置：选择此选项可打开 npm 运行/调试配置对话框，并更新 npm 和 Node.js 运行时的当前设置，参见 npm、pnpm 和 Yarn。排序方式：选择此选项以配置树中脚本的显示顺序。点击工具栏上的，在菜单中选择排序方式，然后选择名称。默认情况下，树按它们在 package.json 中定义的顺序显示脚本（选项定义顺序）。
	隐藏	点击此按钮以隐藏工具窗口。要再次显示它，请在主菜单中选择视图 \| 工具窗口 \| npm。工具窗口将再次显示，包含所有先前构建的任务树。

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

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

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