GoLand 2026.3 Help

运行/调试配置：Karma

创建： 运行 | 编辑配置 | 添加新配置| Karma

在此对话框中，创建使用 JavaScript 单元测试 以及 Karma 测试运行器 的运行和调试配置。

在开始之前

  1. 下载并安装 Node.js。

  2. 按照 Karma 中的描述安装 Karma test runner。

  3. 在 设置 | 插件 中安装 Karma 插件，如 从 JetBrains Marketplace 安装插件中所述。

Karma 特定配置设置

项目

描述

配置文件

在此字段中，指定 Karma configuration file 的位置。 通常，文件具有扩展名 .conf.js

Karma 选项

在此字段中，指定您希望传递给 Karma 的命令行选项，以覆盖 karma.conf.js 配置文件中的默认设置。

例如，要在 Headless Chrome 中运行或调试测试，请在 --browsers ChromeHeadless 字段中输入 Karma 选项。 如需更多信息，请参阅 使用 Headless Chrome 进行自动化测试。

要查看所有可用的 CLI 选项，请在 终端 Alt+F12 中输入 karma start --help。

Node.js 运行时

在此字段中，指定要使用的 Node.js 运行时。

如果您选择了 项目 别名，GoLand 将自动使用 Node.js 运行时 字段中的项目默认解释器。 在大多数情况下， GoLand 会检测到项目的默认运行时，并自动填写该字段。

您还可以选择另一个已配置的本地解释器，或点击 “浏览”按钮 并配置一个新的。

Node 选项

在此字段中，键入要传递给 Node.js 可执行文件的 Node.js 特定命令行选项。

  • 使用 --require coffeescript/register ，运行期间可以将 CoffeeScript 文件即时编译为 JavaScript。

    这种模式要求 register.js 文件（属于 coffeescript 软件包）位于您的项目内。

  • 使用 --inspect 或 --inspect-brk 参数以支持 Chrome Debugging Protocol。

Karma 包

在此字段中，指定以下选项之一：

  • Karma 安装主目录 /npm/node_modules/karma 。 如果您通过 Node Package Manager 正常安装了 Karma ，GoLand 将自行检测 Karma 安装位置。

  • node_modules/@angular/cli 的路径。

  • 如果您使用 Nx， node_modules/nx 的路径。

工作目录

在此字段中，指定应用程序的工作目录。 默认情况下， 工作目录 字段显示项目根文件夹。 若要更改此预定义设置，请指定所需文件夹的路径。

环境变量

在此字段中，您可以选择性地指定用于执行命令的环境变量。

测试

在此区域指定要执行的测试。 可用的选项有：

  • 所有测试： 选择此选项以运行所有来自 karma.conf.js 配置文件的测试。

  • 测试文件： 选择此选项以仅运行某个文件中的测试，并在 测试文件 字段中指定该文件的路径。

  • 套件： 选择此选项以运行测试文件中的单个套件，并在 测试文件 字段中指定此文件的路径。 点击 “浏览”按钮 并在 套件名称 字段中使用 添加 和 移除 按钮配置要运行的套件列表。

  • 测试: 选择此选项以从测试文件运行单个测试，并在 测试文件 字段中指定此文件的路径。 点击 “浏览”按钮 并在 测试名称 字段中配置要运行的测试列表，使用 添加 和 移除 按钮。

通用设置

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

项目

描述

名称

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

存储为项目文件

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

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

步进选项卡

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

逐步进入 会跳过某些脚本，因为通常可能不需要调试它们。 可在 设置 对话框的 构建、执行、部署 | 调试器 | 单步调试 页面上微调此列表 (Ctrl+Alt+S)。

  1. 打开要用于启动调试会话的运行/调试配置，并切换到 单步调试 选项卡。

  2. 要禁止自动 智能单步进入 ，请清除 始终使用智能步入 复选框。

  3. 要跳过源代码映射的 ignoreList 字段中的脚本，请选中 忽略源代码映射中指定的已知第三方脚本 复选框。

    较旧的 Chrome 专用字段名称 x_google_ignoreList 已弃用，但在缺少 ignoreList 字段时仍可能被识别。 请参阅 源代码映射规范了解详情。

  4. 要禁止步进到自定义脚本中，请选中 不步入 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/** 会按如下方式拆分::

  1. 双星号 ** 匹配 node_modules 段之前的任何路径。

  2. node_modules 与 URL 中的 node_modules 匹配。

  3. 双星号 ** 匹配任何尾随内容。

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

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

示例 3

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

  • **/app.js 匹配所有以 app.js 结尾的 URL。

  • 以下模式列表将忽略 node_modules 中除名称为 app.js 的脚本以外的所有脚本。

    **/node_modules/** !**/app.js

工具栏

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

项目

快捷方式

描述

添加按钮

Alt+Insert

创建运行/调试配置。

"移除"按钮

Alt+Delete

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

复制

Ctrl+D

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

保存配置

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

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

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

要创建文件夹，请选择某个类别中的配置，点击 文件夹 ，并指定文件夹名称。 如果只有一个类别处于焦点状态，则会创建一个空文件夹。

然后，为了将配置移动到文件夹中、文件夹之间或者文件夹外，请使用拖拽或 上移 和 下移 按钮。

要删除分组，请选择一个文件夹，然后点击 移除配置。

排序配置

点击此按钮以按字母顺序排序配置。

启动前

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

项目

快捷方式

描述

添加按钮

Alt+Insert

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

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

  • 运行外部工具 ：选择运行外部应用程序。 在打开的对话框中，选择一个或多个您想要运行的应用程序。 如果它在 GoLand 中尚未定义，请添加其定义。

  • 运行另一个配置 ：选择执行另一个运行/调试配置，并等待其完成后再开始当前配置。 如果您想并行运行多个配置，请使用 compound run/debug configuration。

  • 运行 File Watchers ：选择此选项以让 GoLand 应用所有当前活动的 文件监视器。

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

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

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

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

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

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

    指定 Node.js 运行时的位置、要传递给它的参数，以及 gulp 包的路径。

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

    在 NPM Script 对话框中，指定 npm run/debug configuration settings。

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

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

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

  • Go 命令 ：选择此选项以在运行程序之前运行 Go 命令。 例如，您可以运行 go generate 以在编译之前生成源代码。 在 编辑 Go 命令任务 对话框中，您可以使用自动补全。 自动补全支持以下命令 generate、 vet、 test -i。 您可以使用自己的命令。

"移除"按钮

Alt+Delete

点击此图标可将所选任务从列表中移除。

编辑

Enter

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

方法向上

方法 down

Alt+Up

Alt+Down

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

显示此页面

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

激活工具窗口

默认情况下，此复选框处于选中状态，并且在您启动 run/debug 配置时， Run 或 Debug 工具窗口会打开。

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

2026年 11月 9日
运行/调试配置：JestMakefile