运行/调试配置：NPM

创建：运行(U)｜编辑配置(E)｜ | NPM

在此对话框中，创建本地运行 npm 和 Yarn 脚本的配置。当前上下文中的“本地”意味着 JetBrains Rider 自身启动了安装在您电脑上的 Node.js ，随之启动脚本执行。

如果脚本在开发模式下启动应用程序，您可以修改配置，使其也启动调试会话。要实现这一点，请转到 Browser / Live Edit 选项卡，并在那里指定应用程序运行的 URL 地址。了解更多信息，请参阅使用单个 npm run/debug 配置运行和调试 Angular 应用程序、通过单个 npm run/debug 配置运行和调试 Vue.js 应用程序和使用单个 npm run/debug 配置运行和调试 Vite 应用程序。

在开始之前

下载并安装 Node.js。请注意，npm 也已安装，因此如果您要使用它，则已经完成了初步步骤。
要使用 Yarn，请按照 Yarn 官方网站上的说明进行安装。

配置选项卡

条目	描述
package.json	在此字段中，请指定 package.json 文件来运行脚本。从下拉列表中选择文件，该列表显示当前项目中检测到的所有 package.json 文件，或点击并在打开的对话框中选择所需的 package.json 。
命令	从此列表中，选择要执行的 npm CLI command ，默认情况下会选择 `run-script`。请参见 npm 文档中的相关章节了解更多信息 CLI 命令。
脚本	从此下拉列表中选择将应用所选命令的脚本。列表包含 `scripts` 属性中 package.json 文件中定义的所有脚本。
参数	在此字段中，指定用于执行脚本的命令行参数。了解更多信息，请访问 npm 官方网站。
Node 解释器	在此字段中，指定要使用的 Node.js 解释器。如果您选择项目别名，JetBrains Rider 将自动使用 Node 解释器字段中 Node.js 页面的项目默认解释器。在大多数情况下，JetBrains Rider 会检测到项目的默认解释器并自动填写该字段。您也可以选择另一个已配置的本地或远程解释器，或点击并配置一个新的。
节点选项	在此字段中，键入要传递给 Node.js 可执行文件的 Node.js 特定命令行选项。可接受的选项是：使用 `--require coffeescript/register` ，运行期间可以将 CoffeeScript 文件即时编译为 JavaScript。这种模式要求 register.js 文件（属于 `coffeescript` 软件包）位于您的项目内。因此，请确保您已按照安装 CoffeeScript 编译器中的说明，在本地安装了 `coffeescript` 包。使用 `--inspect` 或 `--inspect-brk` 参数以支持 Chrome Debugging Protocol。
包管理器	在此领域。指定要使用的软件包管理器。如果您选择 `项目` 别名，JetBrains Rider 将使用 Node.js 页面中的默认项目包管理器。您还可以选择相关的软件包别名（npm 或 yarn ）或指定自定义安装的软件包管理器的显式路径。
环境变量	在此字段中，指定 Node.js 可执行文件的环境变量（如果适用）。点击浏览字段右侧，在打开的环境变量对话框中配置变量列表：要定义一个新变量，请点击并指定变量名称和值。要取消变量定义，请在列表中选择它并点击。请点击确定，准备就绪后变量的定义显示在环境变量只读字段中，以分号作为分隔符，例如： `NODE_PATH` ：一个 `：` 分隔的目录列表，前缀到模块搜索路径。 `NODE_MODULE_CONTEXTS` ：设置为 1 以在其各自的全局上下文中加载模块。 `NODE_DISABLE_COLORS` ：设为 1 以禁用 REPL 中的颜色。
Docker 容器设置	此只读字段显示端口和卷绑定。请点击以打开命令预览。仅当选择基于 Docker 的远程解释器时才显示此字段。
Docker Compose	在此区域中，指定要传递给 Docker Compose 的命令和选项。接受默认设置或点击并指定自定义设置，比如，自定义 Docker Compose 标志，如 `--rm` 或 `--service-ports`。了解更多信息，请访问 Docker 官方网站。请检查命令预览。仅当选择通过 Docker Compose 的远程解释器时，此字段才会出现。

通用设置

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

条目	描述
名称(N)	为运行配置指定一个名称，以便在编辑或运行时能快速识别。
允许多个实例(U)	允许并行运行多个此运行配置实例。默认情况下，它是禁用的，当您在另一个实例仍在运行时启动此配置时，JetBrains Rider建议停止正在运行的实例并启动另一个实例。这在运行配置消耗大量资源且没有充分理由运行多个实例时非常有用。
存储为项目文件(S)	将运行配置设置保存到文件中，以便与其他团队成员共享。默认位置是 .idea/runConfigurations 。但是，如果您不想共享 .idea 目录，您可以将配置保存到项目中的任何其他目录。默认情况下，它是禁用的，并且 JetBrains Rider 将运行配置设置存储在 .idea/workspace.xml 。

条目

描述

名称(N)

为运行配置指定一个名称，以便在编辑或运行时能快速识别。

允许多个实例(U)

允许并行运行多个此运行配置实例。

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

存储为项目文件(S)

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

默认情况下，它是禁用的，并且 JetBrains Rider 将运行配置设置存储在 .idea/workspace.xml 。

运行/调试配置的树状视图具有一个工具栏，可帮助您管理解决方案中可用的配置，并调整默认配置模板。

条目	快捷方式	描述
	`Alt+Insert`	创建运行/调试配置。
	`Alt+Delete`	删除选定的运行/调试配置。请注意，您不能删除默认配置。
	`Ctrl+D`	创建选定运行/调试配置的副本。请注意，您正在创建默认配置的副本。
		仅当您选择一个临时配置时才会显示该按钮。点击此按钮以将临时配置保存为永久配置。
		移入新建文件夹／新建文件夹。您可以通过将它们放入文件夹来对运行/调试配置进行分组。要创建文件夹，请选择某个类别中的配置，点击，并指定文件夹名称。如果只有一个类别处于焦点状态，则会创建一个空文件夹。然后，为了将配置移动到文件夹中、文件夹之间或者文件夹外，请使用拖拽或和按钮。要删除分组，请选择一个文件夹，然后点击。
		点击此按钮以按字母顺序排序配置。

启动前

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

条目	快捷方式	描述
	`Alt+Insert`	点击此图标以添加下列可用任务之一：运行外部工具：选择运行外部应用程序。在打开的对话框中，选择一个或多个您想要运行的应用程序。如果它在 JetBrains Rider 中尚未定义，请添加其定义。运行另一个配置：选择执行另一个运行/调试配置，并等待其完成后再开始当前配置。如果您想并行运行多个配置，请使用复合运行/调试配置。构建解决方案：选择此选项以在启动配置之前构建解决方案。运行File Watcher ：选择此选项以让 JetBrains Rider 应用所有当前活动的文件监视器。运行远程外部工具：添加一个 remote SSH external tool。运行Grunt 任务：选择此选项来运行 Grunt 任务。在打开的 Grunt 任务对话框中，指定定义所需任务的 Gruntfile.js ，选择要执行的任务，并指定传递给 Grunt 工具的参数。指定 Node.js 解释器的位置、传递给它的参数，以及 grunt-cli 包的路径。运行 Gulp 任务：选择此选项以运行 Gulp task。在打开的 Gulp 任务对话框中，指定定义所需任务的 Gulpfile.js ，选择要执行的任务，并指定要传递给 Gulp 工具的参数。指定 Node.js 解释器的位置、传递给解释器的参数以及到 gulp 包的路径。运行 npm Script ：选择此选项来执行一个 npm 脚本。在 NPM Script 对话框中，指定 npm run/debug configuration settings。编译TypeScript ：选择运行内置的 TypeScript 编译器，从而确保您对 TypeScript 代码所做的所有更改都反映在生成的 JavaScript 文件中。在打开的 TypeScript 编译设置对话框中，选择或清除此检查错误复选框，以配置编译器在检测到错误时的行为: 如果选中了检查错误复选框，编译器会显示所有错误，并且运行配置将不会启动。如果清除了检查错误复选框，编译器将显示所有检测到的错误，但运行配置仍将启动。生成CoffeeScript 源映射：选择此选项以生成 CoffeeScript 源代码的源映射。在打开的对话框中，指定您的 CoffeeScript 源文件所在的位置。
	`Alt+Delete`	点击此图标可将所选任务从列表中移除。
	`Enter`	点击此图标可编辑选定的任务。在打开的对话框中进行必要的更改。
	`Alt+Up` `Alt+Down`	点击这些图标以在列表中将所选任务上移或下移一行。任务将按照它们在列表中出现的顺序执行。
显示此页面		选择此复选框，以便在实际启动运行/调试配置之前显示运行/调试配置设置。
激活工具窗口		默认情况下，此复选框处于选中状态，并且在您启动 run/debug 配置时， Run 或 Debug 工具窗口会打开。否则，如果复选框未选中，工具窗口将被隐藏。但是，当配置正在运行时，您可以通过按 `Alt+4` 或 `Alt+5` 自行打开相应的工具窗口。

浏览器 / 实时编辑选项卡

如果您希望运行/调试配置在开发模式下启动应用程序并同时开始调试会话，请使用此选项卡中的控件。从使用单个 npm run/debug 配置运行和调试 Angular 应用程序、通过单个 npm run/debug 配置运行和调试 Vue.js 应用程序和使用单个 npm run/debug 配置运行和调试 Vite 应用程序了解更多。

您还可以启用 JetBrains Rider 在浏览器中打开应用程序。

条目	描述
打开浏览器	在此区域中，启用应用程序在浏览器中打开。启动后 - 选择此复选框以在启动时打开应用程序。从列表中选择浏览器以打开应用程序。如果您要调试应用程序，请选择 Google Chrome 或另一个 Chromium-based browser。 URL - 在此字段中，指定应用程序将运行的 URL 地址。使用 JavaScript 调试器 - 选中此复选框，即可在应用程序以开发模式启动时同时开始调试会话。

条目

描述

打开浏览器

在此区域中，启用应用程序在浏览器中打开。

启动后 - 选择此复选框以在启动时打开应用程序。从列表中选择浏览器以打开应用程序。
如果您要调试应用程序，请选择 Google Chrome 或另一个 Chromium-based browser。
URL - 在此字段中，指定应用程序将运行的 URL 地址。
使用 JavaScript 调试器 - 选中此复选框，即可在应用程序以开发模式启动时同时开始调试会话。

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