PyCharm 2025.3 Help

运行/调试配置:Karma

创建: 运行(U) | 编辑配置(E) | 添加新配置| Karma

在此对话框中,创建用于运行和调试 JavaScript 单元测试 并使用 Karma 测试运行程序 的配置。

开始之前

  1. 下载并安装 Node.js

  2. 安装 Karma 测试运行程序 ,如 Karma 中所述。

  3. 设置 | 插件 页面、 市场 选项卡上安装 Karma 插件,具体请参阅 从 JetBrains Marketplace 安装插件

Karma 专用配置设置

项目

描述

配置文件

在此字段中,指定 Karma 配置文件 的位置。 通常,该文件的扩展名为 .conf.js

Karma 选项

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

例如,要在 Headless Chrome 中运行或调试测试,请在 Karma 选项 字段中键入 --browsers ChromeHeadless。 有关详细信息,请参阅 使用 Headless Chrome 进行自动化测试

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

Node 运行时

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

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

您也可以选择其他已配置的本地或远程解释器,或点击 浏览按钮 并配置一个新的。

Node 选项

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

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

    此模式要求 register.js 文件(属于 coffeescript 包的一部分)位于您的项目中。 因此,请确保已按照 安装 CoffeeScript 编译器 中的说明在本地安装 coffeescript 包。

  • 使用 --inspect--inspect-brk 参数以支持 Chrome 调试协议

Karma 包

在此字段中,指定以下之一:

  • Karma 安装主目录 /npm/node_modules/karma 。 如果您通过 Node 包管理器 常规安装了 Karma ,PyCharm 会自动检测到 Karma 安装主目录。

  • node_modules/@angular/cli 的路径。

  • 如果您使用 Nx ,则到 node_modules/nx 的路径。

工作目录

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

环境变量

在此字段中,可选地指定执行命令所用的环境变量。

测试

在此区域中,指定要执行的测试。 可用选项如下:

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

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

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

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

通用设置

编辑运行配置(而非运行配置模板)时,您可以指定以下选项:

项目

描述

名称(N)

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

允许多个实例(U)

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

默认情况下,该选项处于禁用状态;当您在另一个实例仍在运行时启动此配置,PyCharm 会建议先停止正在运行的实例,再启动另一实例。 当某个运行配置占用大量资源且没有充分理由运行多个实例时,此设置会很有帮助。

存储为项目文件(S)

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

默认情况下,该选项处于禁用状态,PyCharm 会将运行配置设置存储在 .idea/workspace.xml 中。

工具栏

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

项目

快捷键

描述

添加按钮

Alt+Insert

创建运行/调试配置。

移除按钮

Alt+Delete

删除所选运行/调试配置。 请注意,无法删除默认配置。

复制

Ctrl+D

创建所选运行/调试配置的副本。 请注意,您可以创建默认配置的副本。

保存配置

仅在您选择 临时配置 时显示此按钮。 点击此按钮将临时配置保存为永久配置。

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

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

要创建文件夹,请在某个类别内选择配置,点击 文件夹 ,并指定文件夹名称。 如果只有类别处于焦点,将创建一个空文件夹。

然后,要将配置移动到文件夹中、在文件夹之间移动或将其移出文件夹,请使用拖动,或使用 上移下移 按钮。

要移除分组,请选择一个文件夹并点击 移除配置

排序配置

点击此按钮可按字母顺序对配置进行排序。

启动前

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

项目

快捷键

描述

添加按钮

Alt+Insert

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

  • 启动Web 浏览器 :选择此选项以启动浏览器。 在打开的对话框中,选择浏览器类型并提供起始 URL。 此外,指定是否使用 JavaScript 调试器启动该浏览器。

  • 运行外部工具 :选择运行外部应用程序。 在打开的对话框中,选择要运行的一个或多个应用程序。 如果尚未在 PyCharm 中定义,请添加其定义。 有关详细信息,请参阅 外部工具外部工具

  • 运行另一个配置 :选择执行另一项运行/调试配置,并在其完成后再启动当前配置。 如果您想并行运行多个配置,请使用 复合运行/调试配置

  • 运行File Watcher :选择此选项以让 PyCharm 应用所有当前处于活动状态的 File Watchers

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

  • 运行Grunt 任务 :选择此选项以运行 Grunt 任务。

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

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

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

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

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

  • 运行 npm 脚本 :选择此选项以执行 npm 脚本。

    在打开的 NPM 脚本 对话框中,指定 npm 运行/调试配置设置

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

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

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

  • 生成CoffeeScript 源映射 :选择此选项以为您的 CoffeeScript 源生成源映射。 在打开的对话框中,指定您的 CoffeeScript 源文件的位置。

移除按钮

Alt+Delete

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

编辑

Enter

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

方法上移

方法下移

Alt+Up

Alt+Down

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

显示此页面

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

激活工具窗口

默认情况下,此复选框处于选中状态,启动运行/调试配置时会打开 RunDebug 工具窗口。

否则,如果清除此复选框,将隐藏该工具窗口。 不过,当该配置正在运行时,您可以按 Alt+4Alt+5 自行打开相应的工具窗口。

最后修改日期: 2025年 12月 2日