# 运行/调试配置：NodeUnit

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/clion/llms.txt).

> **TL;DR**
> 必需插件  :
>
>
>
> `JavaScript 和 TypeScript` ，  `Node.js`  -  插件已与 CLion 捆绑并默认启用。

> **Warning:**
> 自 2018 年 5 月起，Nodeunit 已被弃用。 如需更多信息，请参考 [Nodeunit official website](https://github.com/caolan/nodeunit#nodeunit)。

创建：  `运行 | 编辑配置 |`  ![添加新配置](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)  `| 节点单元`

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

## 在开始之前

Procedure:

1. 下载并安装 [Node.js](http://nodejs.org/#download)。

2. 请确保  JavaScript 和 TypeScript  以及  Node.js  所需的插件已在   设置 | 插件   页面上启用。 有关更多信息，请参阅 [管理插件](managing-plugins.html)。

3.

4. 请通过以下其中一种方式安装  Nodeunit  测试框架：

* 请在 [https://github.com/caolan/nodeunit](https://github.com/caolan/nodeunit) 下载该框架并按照官方说明进行安装。

* 请按照 [npm、pnpm 和 Yarn](installing-and-removing-external-software-using-node-package-manager.html)中所述，使用 Node Package Manager (NPM) 安装 `nodeunit` 软件包。

## NodeUnit 专用配置设置

|  项  |  描述  |
| --- | --- |
|  Node.js 运行时  |     在此字段中，指定要使用的 Node.js 运行时。       如果您选择   项目   别名， CLion 将自动使用在 [JavaScript 运行时](javascript-runtime.html) 页面上   Node.js 运行时   字段中的项目默认解释器。 在大多数情况下， CLion 会检测到项目的默认运行时，并自动填写该字段。       您还可以选择另一个已配置的本地解释器，或点击 ![“浏览”按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg) 并配置一个新的。     |
|  工作目录  |  在此字段中，指定查找测试的文件夹。 这可以是项目根文件夹或  `test`  文件夹的父目录。 请手动输入路径或点击   浏览   ![“浏览”按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg)，并在打开的对话框中选择位置。  |
|  环境变量  |     在此字段中，指定 Node.js 可执行文件的自定义 [环境变量](https://www.w3schools.com/nodejs/nodejs_environment.asp)。       变量定义显示在   环境变量   字段中，并以分号（  `;` ）作为分隔符，例如：        * `NODE_PATH` 解析模块时要搜索的附加目录列表。 在 macOS 或 Linux 上使用冒号（ `:` ）分隔目录列表，在 Windows 上使用分号（ `;` ）。    * `NODE_MODULE_CONTEXTS` 设置为 1 以在各自的全局上下文中加载模块。    * `NODE_DISABLE_COLORS` 设置为 1 以在 REPL 中禁用颜色。     ![环境变量](https://resources.jetbrains.com/help/img/idea/2026.3/nodeEnvironmentVariables.png)    或者点击字段右侧的   浏览   ![编辑环境变量图标](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.inline.variables.svg)，并在打开的   环境变量   对话框中配置变量列表：        * 使用 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)、 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.remove.svg)、 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.copy.svg) 和 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.paste.svg) 按钮管理自定义变量列表。    * 该对话框还会显示可用的系统环境变量列表。 如果不想为当前配置使用系统环境变量，请取消选中 包含系统环境变量 复选框。    * 请点击 确定 ，准备就绪后.    |
|  NodeUnit 模块  |  在此字段中，请指定  Nodeunit  框架的安装文件夹。 请手动输入路径或点击 ![“浏览”按钮](https://resources.jetbrains.com/help/img/idea/2026.3/workspace.xml` 。     |

## 工具栏

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

|  项  |  快捷方式  |  描述  |
| --- | --- | --- |
|  ![添加按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)  |  `Alt+Insert` (Windows), `⌘ N` (macOS), `⌃ N` (IntelliJ IDEA Classic (macOS)), `⌘ N` (macOS System Shortcuts), `Alt+Insert` (XWin), `Alt+Insert` (GNOME), `Alt+Insert` (KDE), `Alt+Insert` (Emacs), `Ctrl+N` (Sublime Text), `⌘ N` (Sublime Text (macOS)), `⌘ N` (Xcode), `Ctrl+N` (Visual Studio), `⌘ N` (Visual Studio (macOS)), `Alt+Insert` (ReSharper), `⌥ Insert` (ReSharper (macOS)), `Alt+Insert` (QtCreator), `Alt+Insert` (QtCreator (macOS)), `Alt+Insert` (NetBeans), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS))  |  创建运行/调试配置。  |
|  !["移除"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.remove.svg)  |  `Alt+Delete` (Windows), `⌘ ⌦` (macOS), `⌘ ⌦` (IntelliJ IDEA Classic (macOS)), `⌘ ⌦` (macOS System Shortcuts), `Alt+Delete` (XWin), `Alt+Delete` (GNOME), `Alt+Delete` (KDE), `Alt+Delete` (Emacs), `Alt+Delete` (Sublime Text), `⌘ ⌦` (Sublime Text (macOS)), `⌘ ⌦` (Xcode), `Ctrl+R, D` (Visual Studio), `⌘ R, D` (Visual Studio (macOS)), `Alt+Delete` (ReSharper), `⌥ ⌦` (ReSharper (macOS)), `Alt+Delete` (QtCreator), `⌘ ⌦` (QtCreator (macOS)), `Alt+Delete` (NetBeans), `Alt+Delete` (Eclipse), `Alt+Delete` (Eclipse (macOS))  |  删除选定的运行/调试配置。 请注意，您不能删除默认配置。  |
|  ![复制](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.copy.svg)  |  `Ctrl+D` (Windows), `⌘ D` (macOS), `⌘ D` (IntelliJ IDEA Classic (macOS)), `⌘ D` (macOS System Shortcuts), `Ctrl+D` (XWin), `Ctrl+D` (GNOME), `Ctrl+D` (KDE), `Meta+D` (Emacs), `Ctrl+Shift+D` (Sublime Text), `⌘ ⇧ D` (Sublime Text (macOS)), `⌘ D` (Xcode), `Ctrl+D` (Visual Studio), `⌘ D` (Visual Studio (macOS)), `Ctrl+D` (ReSharper), `⌘ D` (ReSharper (macOS)), `Ctrl+D` (QtCreator), `⌘ D` (QtCreator (macOS)), `Ctrl+D` (NetBeans), `Ctrl+D` (Eclipse), `Ctrl+D` (Eclipse (macOS))  |  创建选定运行/调试配置的副本。 请注意，您正在创建默认配置的副本。  |
|  ![保存配置](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.save.svg)  |  |  仅当您选择一个 [临时配置](null)时才会显示该按钮。 点击此按钮以将临时配置保存为永久配置。  |
|  ![移动到新文件夹／创建新文件夹](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.actions.newFolder.svg)  |  |     移入新建文件夹／新建文件夹。 您可以通过 [将它们放入文件夹](run-debug-configuration.html#config-folders)来对运行/调试配置进行分组。       要创建文件夹，请选择某个类别中的配置，点击 ![文件夹](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.nodes.folder.svg)，并指定文件夹名称。 如果只有一个类别处于焦点状态，则会创建一个空文件夹。       然后，为了将配置移动到文件夹中、文件夹之间或者文件夹外，请使用拖拽或 ![上移](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.moveUp.svg) 和 ![下移](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.moveDown.svg) 按钮。       要删除分组，请选择一个文件夹，然后点击 ![删除配置](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.remove.svg)。     |
|  ![排序配置](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.objectBrowser.sortAlphabetically.svg)  |  |  点击此按钮以按字母顺序排序配置。  |

## 启动前

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

|  项  |  快捷方式  |  描述  |
| --- | --- | --- |
|  ![添加按钮](https://resources.jetbrains.com/help/img/idea/2026.3/调试配置](run-debug-multiple.html#compound-configs)。    * 运行 File Watchers​ ：选择此选项以让 CLion 应用所有当前活动的 [文件监视器](using-file-watchers.html)。    * 运行 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](null)。    * 编译 TypeScript ：选择运行内置的 TypeScript 编译器，从而确保您对 TypeScript 代码所做的所有更改都反映在生成的 JavaScript 文件中。 在打开的 TypeScript 编译设置 对话框中，选择或清除此 检查错误 复选框，以配置编译器在检测到错误时的行为: * 如果选中了 检查错误 复选框，编译器会显示所有错误，并且运行配置将不会启动。 * 如果清除了 检查错误 复选框，编译器将显示所有检测到的错误，但运行配置仍将启动。    * 生成 CoffeeScript 源地图 ：选择此选项以生成 [CoffeeScript](coffeescript.html) 源代码的源映射。 在打开的对话框中，指定您的 CoffeeScript 源文件所在的位置。    |
|  !["移除"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.remove.svg)  |  `Alt+Delete` (Windows), `⌘ ⌦` (macOS), `⌘ ⌦` (IntelliJ IDEA Classic (macOS)), `⌘ ⌦` (macOS System Shortcuts), `Alt+Delete` (XWin), `Alt+Delete` (GNOME), `Alt+Delete` (KDE), `Alt+Delete` (Emacs), `Alt+Delete` (Sublime Text), `⌘ ⌦` (Sublime Text (macOS)), `⌘ ⌦` (Xcode), `Ctrl+R, D` (Visual Studio), `⌘ R, D` (Visual Studio (macOS)), `Alt+Delete` (ReSharper), `⌥ ⌦` (ReSharper (macOS)), `Alt+Delete` (QtCreator), `⌘ ⌦` (QtCreator (macOS)), `Alt+Delete` (NetBeans), `Alt+Delete` (Eclipse), `Alt+Delete` (Eclipse (macOS))  |  点击此图标可将所选任务从列表中移除。  |
|  ![编辑](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.edit.svg)  |  `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `⏎` (Xcode), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (ReSharper), `⏎` (ReSharper (macOS)), `Enter` (QtCreator), `⏎` (QtCreator (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS))  |  点击此图标可编辑选定的任务。 在打开的对话框中进行必要的更改。  |
|     ![方法向上](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.moveUp.svg)       ![方法 down](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.moveDown.svg)     |     `Alt+Up` (Windows), `⌃ ⇧ ↑` (macOS), `⌃ ↑` (IntelliJ IDEA Classic (macOS)), `⌃ ⌥ ↑` (macOS System Shortcuts), `Alt+Up` (XWin), `Alt+Up` (GNOME), `Alt+Up` (KDE), `Alt+Up` (Emacs), `Alt+Up` (Sublime Text), `Alt+Up` (Sublime Text (macOS)), `⌥ ↑` (Xcode), `Alt+Up` (Visual Studio), `⌃ ⇧ ↑` (Visual Studio (macOS)), `Alt+Up` (ReSharper), `⌃ ⇧ ↑` (ReSharper (macOS)), `Alt+Up` (QtCreator), `⌃ ⇧ ↑` (QtCreator (macOS)), `Ctrl+Alt+Up` (NetBeans), `Ctrl+Shift+Up` (Eclipse), `⌃ ⌥ ↑` (Eclipse (macOS))       `Alt+Down` (Windows), `⌃ ⇧ ↓` (macOS), `⌃ ↓` (IntelliJ IDEA Classic (macOS)), `⌃ ⌥ ↓` (macOS System Shortcuts), `Alt+Down` (XWin), `Alt+Down` (GNOME), `Alt+Down` (KDE), `Alt+Down` (Emacs), `Alt+Down` (Sublime Text), `Alt+Down` (Sublime Text (macOS)), `⌥ ↓` (Xcode), `Alt+Down` (Visual Studio), `⌃ ⇧ ↓` (Visual Studio (macOS)), `Alt+Down` (ReSharper), `⌃ ⇧ ↓` (ReSharper (macOS)), `Alt+Down` (QtCreator), `⌃ ⇧ ↓` (QtCreator (macOS)), `Ctrl+Alt+Down` (NetBeans), `Ctrl+Shift+Down` (Eclipse), `⌃ ⌥ ↓` (Eclipse (macOS))     |  点击这些图标以在列表中将所选任务上移或下移一行。 任务将按照它们在列表中出现的顺序执行。  |
|  显示此页面  |  |  选择此复选框，以便在实际启动运行/调试配置之前显示运行/调试配置设置。  |
|  激活工具窗口  |  |     默认情况下，此复选框处于选中状态，并且在您启动 run/debug 配置时， [Run](run-tool-window.html) 或 [Debug](debug-tool-window.html) 工具窗口会打开。       否则，如果复选框未选中，工具窗口将被隐藏。 但是，当配置正在运行时，您可以通过按 `Alt+4` (Windows), `⌘ 4` (macOS), `⌘ 4` (IntelliJ IDEA Classic (macOS)), `⌘ 4` (macOS System Shortcuts), `Alt+4` (XWin), `Alt+4` (GNOME), `Alt+4` (KDE), `Alt+4` (Emacs), `Alt+4` (Sublime Text), `⌘ 4` (Sublime Text (macOS)), `⌘ 6` (Xcode), `Alt+4` (Visual Studio), `⌘ 4` (Visual Studio (macOS)), `Alt+4` (ReSharper), `⌘ 4` (ReSharper (macOS)), `Alt+3` (QtCreator), `⌘ 3` (QtCreator (macOS)), `Alt+4` (NetBeans), `Alt+4` (Eclipse), `⌘ 4` (Eclipse (macOS)) 或 `Alt+5` (Windows), `⌘ 5` (macOS), `⌘ 5` (IntelliJ IDEA Classic (macOS)), `⌘ 5` (macOS System Shortcuts), `Alt+5` (XWin), `Alt+5` (GNOME), `Alt+5` (KDE), `Alt+5` (Emacs), `Alt+5` (Sublime Text), `⌘ 5` (Sublime Text (macOS)), `⌘ 7` (Xcode), `Alt+5` (Visual Studio), `⌘ 5` (Visual Studio (macOS)), `Alt+5` (ReSharper), `⌘ 5` (ReSharper (macOS)), `Alt+5` (QtCreator), `⌘ 5` (QtCreator (macOS)), `Alt+5` (NetBeans), `Alt+5` (Eclipse), `⌘ 5` (Eclipse (macOS)) 自行打开相应的工具窗口。     |

## See also

### 流程

