运行/调试配置：Mocha

创建：运行 | 编辑配置 | | Mocha

本页介绍特定于该配置的项目，以及所有运行/调试配置通用的选项。有关使用此配置的更多信息，请参阅 Mocha。

在此对话框中，创建用于运行和调试 JavaScript unit tests 的配置，使用 Mocha test framework。

开始之前

下载并安装 Node.js。
请确保 JavaScript 和 TypeScript 和 Node.js 所需的插件已在设置 | 插件页面上启用。有关更多信息，请参阅管理插件。

Mocha 特定配置设置

条目	描述
Node.js 运行时	在此字段中，指定要使用的 Node.js 运行时。选择已配置的运行时之一，或点击并按照配置本地 Node.js 运行时中的说明配置新的运行时。如果您选择 `项目` 别名，IntelliJ IDEA 将自动使用 JavaScript 运行时环境页面上 Node.js 运行时字段中的项目默认运行时。
Node 选项	在此字段中，键入要传递给 Node.js 可执行文件的 Node.js 特定命令行选项。如需更多信息，请参阅 Node Parameters。
工作目录	在此字段中，指定应用程序的工作目录。默认情况下，工作目录字段显示项目根文件夹。若要更改此预定义设置，请指定所需文件夹的路径。
环境变量	在此字段中，指定 Node.js 可执行文件的自定义环境变量。变量定义显示在环境变量字段中，并用分号 (`;`) 分隔，例如： `NODE_PATH` 用于解析模块时搜索的附加目录列表。在 macOS 或 Linux 上，目录列表请用冒号 (`:`) 分隔；在 Windows 上请用分号 (`;`) 分隔。 `NODE_MODULE_CONTEXTS` 设置为 1 以在各自的全局上下文中加载模块。 `NODE_DISABLE_COLORS` 设置为 1 以在 REPL 中禁用颜色。或者，点击字段右侧的浏览，并在打开的环境变量对话框中配置变量列表：请使用、、和按钮来管理自定义变量列表。该对话框还会显示可用的系统环境变量列表。如果不想为当前配置使用系统环境变量，请清除包括系统环境变量复选框。准备就绪后，点击 OK。
Mocha package	在此字段中，指定 Mocha 安装目录 /npm/node_modules/mocha 。如果您通过 Mocha 定期安装 Node Package Manager ，IntelliJ IDEA 会自行检测到 Mocha 安装主目录。或者，手动输入可执行文件的路径，或者点击浏览，并在打开的对话框中选择位置。
用户接口	请从此列表中选择编写在 test folder中的测试所依据的 interface。 IntelliJ IDEA 只会识别符合所选接口的测试。如果在测试执行期间 IntelliJ IDEA 运行到另一个接口的测试，测试会话将因错误而取消。这意味着在指定的测试文件夹中的所有测试都必须按照相同的接口编写，并且该接口必须从列表中选择。
其他 Mocha 选项	在此字段中，指定其他 Mocha command-line options。例如，添加一个 `--watch` 标志以启用类似自动测试的运行程序。因此，在当前运行配置中，任何测试在更改相关源代码时都会自动重新启动，无需点击重新运行按钮。
测试	在此区域指定要执行的测试。可用选项包括：目录中的全部：选择此选项以运行存储在文件夹中的所有测试，并在测试目录字段中指定该文件夹的路径。要在指定目录下的子文件夹中查找测试，请选中包含子目录复选框。文件模式：选择此选项可在名称与特定条件匹配的所有文件中查找测试。在测试文件模式字段中使用 glob 模式指定掩码，例如： .test.js 如果包含测试的文件存储在单独的文件夹中，例如 test ，请在相对于工作目录的模式中指定此文件夹的路径： ./folder1/folder2/test/.test.js 测试文件：选择此选项可仅运行单个文件中的测试，并在测试文件字段中指定此文件的路径。套件：选择此选项可运行测试文件中的单个套件，并在测试文件字段中指定此文件的路径。点击套件名称字段中的，并使用和按钮配置要运行的套件列表。测试：选择此选项可运行测试文件中的单个测试，并在测试文件字段中指定此文件的路径。点击测试名称字段中的，并使用和按钮配置要运行的测试列表。
Docker 容器设置	此只读字段显示端口和卷绑定。请点击以打开命令预览。仅当选择基于 Docker 的远程解释器时才显示此字段。
Docker Compose	在此区域中，指定要传递给 Docker Compose 的命令和选项。接受默认设置或点击并指定自定义设置，比如，自定义 Docker Compose 标志，如 `--rm` 或 `--service-ports`。了解更多信息，请访问 Docker 官方网站。请检查命令预览。仅在选择通过 Docker Compose 的远程运行时时，才会显示此字段。

通用设置

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

条目	描述
名称	在编辑或运行时，指定运行配置的名称以便快速识别。
存储为项目文件	将运行配置设置的文件保存下来，与其他团队成员共享。默认位置是 .idea/runConfigurations 。但是，如果您不想共享 .idea 目录，您可以将配置保存到项目内的任何其他目录。默认情况下，它是禁用的，并且 IntelliJ IDEA 将运行配置设置存储在 .idea/workspace.xml 。

条目

描述

名称

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

存储为项目文件

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

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

步进选项卡

在此选项卡上，指定步进选项。

某些脚本（例如标准 Java 类的方法，如 系统 ）会被步入跳过，因为通常可能不需要调试它们。您可以在构建、执行、部署 | 调试器 | 单步调试页面的设置对话框中（Ctrl+Alt+S ）微调此列表。

打开运行/调试配置以启动调试会话，并切换到步进选项卡。
要禁止自动智能步入，请清除始终使用智能步入复选框。
要跳过源代码映射的 ignoreList 字段中的脚本，请选中忽略源代码映射中指定的已知第三方脚本复选框。
较旧的 Chrome 专用字段名称 x_google_ignoreList 已弃用，但当缺少 ignoreList 字段时，仍可能被识别。从源代码映射规范中了解详情。
要禁止步进进入自定义脚本，请选中不步入 URL 与以下模式匹配的脚本复选框，并展开下面此类脚本的默认列表。使用 *、 ?、 ** 和 !。

模式语法

模式中支持以下字符：

星号 * 会匹配除斜杠 / 以外的零个或多个字符。在单个路径部分内使用此字符。
问号 ? 会匹配除斜杠 / 以外的正好一个字符。
双星号 ** 作为整个段时，会匹配零个或多个路径段。其含义取决于它的位置：
- 作为第一部分时，它会匹配任意前导符号。
- 作为最后一部分时，它会匹配任意尾随符号。
- 在中间时，它会匹配一个或多个部分。例如， a/**/b 会匹配 a/x/b 和 a/x/y/b ，但不匹配 a/b。
位于最后一个段末尾的尾随双星号 ** （本身不是一个完整段，例如 foo** ）会匹配该段之后的任何后缀。例如， foo** 会匹配 foo、 foobar 和 foo/bar。
以感叹号 ! 开头的模式会对给定模式取反，并修改列表中在它之前添加的模式。它本身不会添加新模式。

示例 1

在模式列表 ["**/*.ts", "!**/*.test.ts"] 中，第一个 glob 会匹配每个 .ts 文件。第二个模式会修改第一个 glob，以从匹配中排除每个 .test.ts 文件。

示例 2

传入的 URL 会通过斜杠 / 拆分为多个部分。因此， **/node_modules/** 会按如下方式拆分::

双星号 ** 会匹配 node_modules 段之前的任何路径。
node_modules 会匹配 URL 中的 node_modules。
双星号 ** 会匹配后面的任何内容。

因此，模式 **/node_modules/** 会匹配包含 node_modules 的任何 URL。

请记住，脚本的 URL 会与整个模式进行匹配。如果移除第二个双星号 ** ，该模式将匹配任何以 node_modules 结尾的 URL，而这样的 URL 可能为零。

示例 3

跳过第二个双星号 ** ，以匹配以特定文件名结尾的任何模式。

**/app.js 会匹配所有以 app.js 结尾的 URL。
以下模式列表将忽略 node_modules 中除名称为 app.js 的脚本之外的所有脚本。
**/node_modules/** !**/app.js

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

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

启动前

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

条目	快捷键	描述
	`Alt+Insert`	点击此图标以添加以下可用任务之一：启动 Web 浏览器‍™™™™™™™‍ ：选择此选项以启动浏览器。在打开的对话框中，选择浏览器类型并提供起始 URL。此外，请指定是否要使用 JavaScript 调试器启动浏览器。运行外部工具：选择运行外部应用。在打开的对话框中，选择您想要运行的一个或多个应用程序。如果它在 IntelliJ IDEA 中尚未定义，请添加其定义。如需更多信息，请参阅外部工具和外部工具设置。运行另一个配置：选择执行另一个运行/调试配置，并等待其完成后再启动当前配置。如果您想并行运行多个配置，请使用 compound run/debug configuration。构建：选择编译指定的模块。 Build Module命令将会被执行。如果在编译过程中发生错误，IntelliJ IDEA 将不会尝试启动运行/调试配置。构建项目：选择编译整个项目。 Build Project 命令将被执行。如果在编译过程中发生错误，IntelliJ IDEA 将不会尝试启动运行/调试配置。构建，不进行错误检查：与构建选项相同，但 IntelliJ IDEA 将会尝试启动运行/调试配置，而不考虑编译结果。构建制品：选择此选项以构建一个或多个构件。在打开的对话框中，选择应构建的 artifact。运行远程外部工具：添加一个远程 SSH 外部工具。运行 Grunt 任务：选择此选项以运行 Grunt 任务。在打开的 Grunt 任务对话框中，指定定义所需任务的 Gruntfile.js ，选择要执行的任务，并指定传递给 Grunt 工具的参数。指定 Node.js 解释器的位置、传递给它的参数以及 grunt-cli 包的路径。运行 Gulp 任务：选择此选项以运行 Gulp 任务。在打开的 Gulp 任务对话框中，请指定定义所需任务的 Gulpfile.js ，选择要执行的任务，并指定传递给 Gulp 工具的参数。指定 Node.js 运行时的位置、要传递给它的参数，以及 gulp 包的路径。运行 Maven 目标：选择此选项以运行一个 Maven 目标。在打开的对话框中，选择要运行的目标。运行 npm 脚本：选择此选项以执行 npm script。在打开的 npm 脚本对话框中，指定 npm 运行/调试配置设置。编译 TypeScript ：选择运行内置的 TypeScript 编译器，从而确保您对 TypeScript 代码所做的所有更改都反映在生成的 JavaScript 文件中。在打开的 TypeScript 编译设置对话框中，选择或清除检查错误复选框，以配置在检测到任何错误时编译器的行为：如果选中检查错误复选框，编译器将显示所有错误，运行配置将不会启动。如果取消选中检查错误复选框，编译器将显示所有检测到的错误，但仍会启动运行配置。生成 CoffeeScript 源代码映射图：选择此选项以为您的 CoffeeScript 源文件生成源代码映射。在打开的对话框中，指定您的 CoffeeScript 源文件所在的位置。运行 Rake 任务：添加一个 Rake 任务，以便在运行或调试之前执行。要选择 Rake 任务，请点击浏览按钮，然后从可用任务列表中选择所需的任务。请注意，此处可使用代码补全。运行 JRuby 编译器：选择此选项，以使用指定的目标路径、编译器进程堆大小和命令行形参（如果有）执行 JRuby 编译器。
	`Alt+Delete`	点击此图标以从列表中删除所选任务。
	`Enter`	点击此图标以编辑所选任务。在打开的对话框中进行必要的更改。
	`Alt+Up` `Alt+Down`	点击这些图标可以将所选任务在列表中上下移动一行。任务按照它们在列表中出现的顺序执行。
显示此页面		选中此复选框，以在实际启动运行/调试配置之前显示运行/调试配置设置。
激活工具窗口		默认情况下，将选中此复选框，启动运行/调试配置时将打开 Run 或 Debug 工具窗口。否则，如果复选框被清除，工具窗口将被隐藏。但是，当配置运行时，您可以通过按 `Alt+4` 或 `Alt+5` 自行打开相应的工具窗口。

2026年 11月 3日