WebStorm 2021.1 Help

运行/调试配置：NPM

运行 | 编辑配置 | 添加新配置 | 新PM

此页面描述了特定于配置的项目以及所有运行/调试配置通用的选项。要了解如何使用此配置，请参阅npm、pnpm 和 Yarn。

在此对话框中，创建用于在本地运行npm和Yarn脚本的配置。当前上下文中的“本地”意味着 WebStorm 本身会启动安装在您计算机上的Node.js ，然后启动脚本执行。

从npm、pnpm 和 Yarn了解更多信息。

在你开始前

  1. 下载并安装Node.js。请注意，npm 也已安装，因此如果您要使用它，您已经完成了初步步骤。

  2. 要使用 Yarn，请按照Yarn 官方网站上的说明进行安装。

配置选项卡

包.json

在此字段中，指定要从中运行脚本的package.json文件。从显示当前项目中检测到的所有package.json文件的下拉列表中选择文件，或在打开的对话框中单击浏览按钮并选择所需的package.json 。

命令

从此列表中，选择要执行的npm CLI 命令，默认情况下run-script是选中的。在npm 文档的CLI 命令部分了解更多信息。

脚本

从此下拉列表中，选择将应用所选命令的脚本。该列表包含package.json文件的scripts属性中定义的所有脚本。

论据

在此字段中，指定用于执行脚本的命令行参数。从npm 官方网站了解更多信息。

节点解释器

在此字段中，指定要使用的 Node.js 解释器。这可以是本地 Node.js 解释器或Windows Subsystem for Linux 上的Node.js。

节点选项

在此文本框中，键入要传递给 Node.js 可执行文件的特定于 Node.js 的命令行选项。可接受的选项是：

  • 用于在运行期间--require coffeescript/register将CoffeeScript文件动态编译成 JavaScript。

    此模式要求作为包一部分的register.jscoffeescript文件位于您的项目中。因此，请确保您已按照安装 CoffeeScript 编译器coffeescript中的说明在本地安装了该软件包。

  • 当您使用 Node.js v7 获得Chrome 调试协议支持时使用--inspect或参数。否则，默认情况下调试过程将使用V8 调试协议。--inspect-brk

包管理器

在这个领域里。指定要使用的包管理器。如果您选择Project别名，WebStorm 将使用Node.js页面中的默认项目包管理器。您还可以选择相关的包别名（npm或yarn）或指定自定义安装包管理器的显式路径。

环境变量

在此字段中，指定 Node.js 可执行文件的环境变量（如果适用）。单击字段右侧的浏览并在打开的 环境变量对话框中配置变量列表：浏览按钮

  • 要定义新变量，请单击添加按钮并指定变量名称和值。

  • 要放弃变量定义，请在列表中选择它并单击删除按钮。

  • 点击OK，准备就绪

变量的定义以分号作为分隔符显示在环境变量只读字段中，例如：

  • NODE_PATH：:以模块搜索路径为前缀的目录的分隔列表。

  • NODE_MODULE_CONTEXTS：设置为 1 以在它们自己的全局上下文中加载模块。

  • NODE_DISABLE_COLORS：设置为 1 以禁用 REPL 中的颜色。

常用设置

当您编辑运行配置（但不是运行配置模板）时，您可以指定以下选项：

姓名

为运行/调试配置指定一个名称，以便在编辑或运行配置时快速识别它，例如，从运行弹出窗口Alt+Shift+F10中。

允许并行运行

选择以允许并行运行此运行配置的多个实例。

默认情况下，它是禁用的，当您在另一个实例仍在运行时启动此配置时，WebStorm 建议停止正在运行的实例并启动另一个实例。当运行/调试配置消耗大量资源并且没有充分理由运行多个实例时，这很有帮助。

存储为项目文件

使用运行配置设置保存文件以与其他团队成员共享。默认位置是.idea/runConfigurations。但是，如果您不想共享.idea目录，您可以将配置保存到项目中的任何其他目录。

默认情况下，它被禁用，WebStorm 将运行配置设置存储在.idea/workspace.xml中。

工具栏

运行/调试配置的树视图有一个工具栏，可帮助您管理项目中可用的配置以及调整默认配置模板。

物品

捷径

描述

添加按钮

Alt+Insert

创建运行/调试配置。

删除按钮

Alt+Delete

删除选定的运行/调试配置。请注意，您不能删除默认配置。

复制

Ctrl+D

创建所选运行/调试配置的副本。请注意，您会创建默认配置的副本。

保存配置

仅当您选择临时配置时才会显示该按钮。单击此按钮可将临时配置保存为永久配置。

移动到新文件夹/创建新文件夹

移动到新文件夹/创建新文件夹。您可以通过将运行/调试配置放入文件夹来对它们进行分组。

要创建文件夹，请选择类别中的配置，单击文件夹，然后指定文件夹名称。如果仅关注一个类别，则会创建一个空文件夹。

然后，要将配置移入文件夹、文件夹之间或移出文件夹，请使用拖动或提升和下移按钮。

要删除分组，请选择一个文件夹并单击删除配置。

排序配置

单击此按钮可按字母顺序对配置进行排序。

发射前

在此区域中，您可以指定在开始选定的运行/调试配置之前要执行的任务。任务按照它们在列表中出现的顺序执行。

物品

捷径

描述

添加按钮

Alt+Insert

单击此图标可添加以下可用任务之一：

  • 启动 Web 浏览器：选择此选项以启动浏览器。在打开的对话框中，选择浏览器类型并提供起始 URL。此外，指定是否希望使用 JavaScript 调试器启动浏览器。

  • 运行外部工具：选择运行外部应用程序。在打开的对话框中，选择一个或多个要运行的应用程序。如果尚未在 WebStorm 中定义，请添加其定义。有关详细信息，请参阅外部工具和外部工具。

  • 运行另一个配置：选择执行另一个运行/调试配置。在打开的对话框中，选择要运行的配置。

  • 运行文件观察器：选择此选项让 WebStorm 应用所有当前活动的文件观察器。

  • 运行远程外部工具：添加远程 SSH 外部工具。

  • 运行 Grunt 任务：选择此选项以运行 Grunt 任务。

    在打开的Grunt 任务对话框中，指定定义所需任务的Gruntfile.js，选择要执行的任务，并指定要传递给 Grunt 工具的参数。

    指定 Node.js 解释器的位置、传递给它的参数以及grunt-cli包的路径。

  • 运行 Gulp 任务：选择此选项以运行 Gulp 任务。

    在打开的Gulp 任务对话框中，指定定义所需任务的Gulpfile.js，选择要执行的任务，并指定要传递给 Gulp 工具的参数。

    指定 Node.js 解释器的位置、传递给它的参数以及gulp包的路径。

  • 运行 npm 脚本：选择此选项以执行 npm 脚本。

    在打开的NPM 脚本对话框中，指定npm 运行/调试配置设置。

  • 编译 TypeScript：选择运行内置的 TypeScript 编译器，从而确保您对 TypeScript 代码所做的所有更改都反映在生成的 JavaScript 文件中。在打开的TypeScript 编译设置对话框中，选中或清除检查错误复选框以配置编译器在检测到任何错误时的行为：

    • 如果选中检查错误复选框，编译器将显示所有错误并且不会启动运行配置。

    • 如果检查错误复选框被清除，编译器将显示所有检测到的错误，但仍将启动运行配置。

  • 生成 CoffeeScript Source Maps：选择此选项可为您的CoffeeScript源生成源映射。在打开的对话框中，指定 CoffeeScript 源文件的位置。

删除按钮

Alt+Delete

单击此图标可从列表中删除选定的任务。

编辑

Enter

单击此图标可编辑选定的任务。在打开的对话框中进行必要的更改。

方法向上/方法向下

Alt+Up/Alt+Down

单击这些图标可在列表中将所选任务向上或向下移动一行。任务按照它们在列表中出现的顺序执行。

显示此页面

选中此复选框可在实际启动运行/调试配置之前显示运行/调试配置设置。

激活工具窗口

默认情况下，此复选框处于选中状态，当您启动运行/调试配置时，运行或调试工具窗口将打开。

否则，如果清除该复选框，则隐藏工具窗口。但是，在配置运行时，您可以通过按Alt+4或自行为其打开相应的工具窗口Alt+5。

最后修改：2021 年 12 月 20 日
npm、pnpm 和 Yarn Endpoints 工具窗口