运行/调试配置：NodeUnit

创建：运行(U)｜编辑配置(E) | 节点单元

在此对话框中，创建运行 Node.js 应用程序单元测试的配置。

在开始之前

下载并安装 Node.js。
确保在 JavaScript and TypeScript和 Node.js必需插件在设置 | 插件页面的已安装标签页上启用。如需了解更多信息，请参阅管理插件。
请通过以下其中一种方式安装 Nodeunit 测试框架：
- 请在 https://github.com/caolan/nodeunit 下载该框架并按照官方说明进行安装。
- 请按照 npm、pnpm 和 Yarn 中所述，使用 Node Package Manager (NPM)安装 nodeunit 软件包。

NodeUnit 专用配置设置

条目	描述
Node 解释器	在此字段中，指定要使用的 Node.js 解释器。如果您选择项目别名，JetBrains Rider 将自动使用 Node 解释器字段中 Node.js 页面的项目默认解释器。在大多数情况下，JetBrains Rider 会检测到项目的默认解释器并自动填写该字段。您也可以选择另一个已配置的本地或远程解释器，或点击并配置一个新的。
工作目录	在此字段中，指定查找测试的文件夹。这可以是项目根文件夹或 test 文件夹的父目录。请手动输入路径或点击浏览，并在打开的对话框中选择位置。
环境变量	在此字段中，指定 Node.js 可执行文件的环境变量（如果适用）。点击浏览字段右侧，在打开的环境变量对话框中配置变量列表：要定义一个新变量，请点击并指定变量名称和值。要取消变量定义，请在列表中选择它并点击。请点击确定，准备就绪后变量的定义显示在环境变量只读字段中，以分号作为分隔符，例如： `NODE_PATH` ：一个 `：` 分隔的目录列表，前缀到模块搜索路径。 `NODE_MODULE_CONTEXTS` ：设置为 1 以在其各自的全局上下文中加载模块。 `NODE_DISABLE_COLORS` ：设为 1 以禁用 REPL 中的颜色。
Nodeunit 模块	在此字段中，请指定 Nodeunit 框架的安装文件夹。请手动输入路径或点击并在打开的对话框中选择文件夹。
运行	从此列表中选择要执行的测试作用域。可用选项有：目录中的所有测试文件：选择此选项以运行文件夹中的所有测试文件，并指定相对于 working directory 的此文件夹的路径。测试文件：选择此选项以从特定文件执行测试，并键入此文件相对于工作目录的路径。

通用设置

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

条目	描述
名称(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`	点击此图标以添加下列可用任务之一：运行 External tool ：选择运行外部应用程序。在打开的对话框中，选择您要运行的一个或多个应用程序。如果它在 JetBrains Rider 中尚未定义，请添加其定义。运行另一个配置：选择执行另一个运行/调试配置，并等待其完成后再开始当前配置。如果您想并行运行多个配置，请使用复合运行/调试配置。构建解决方案：选择此选项以在启动配置之前构建解决方案。运行File Watcher ：选择此选项以让 JetBrains Rider 应用所有当前活动的文件监视器。运行远程外部工具：添加一个远程 SSH 外部工具。运行Grunt 任务：选择此选项来运行 Grunt 任务。在打开的 Grunt task 对话框中，指定定义所需任务的 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` 自行打开相应的工具窗口。

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