WebStorm 2025.2 Help

代码覆盖率

在 WebStorm 中,您还可以监控代码中有多少被 测试覆盖。 WebStorm 会在专用的 覆盖率 工具窗口中显示此统计信息,并在编辑器和 项目 工具窗口中以可视方式标记已覆盖和未覆盖的代码行 Alt+1

覆盖率测量结果会保存在 coverage suite 中。 您还可以将其与任意现有套件合并。 在此情况下,如果某行由至少一个测试运行覆盖,则视为已覆盖。

代码覆盖率测量适用于 JestMochaKarmaVitest

运行带覆盖率的测试

  • 创建一个 JestMochaKarmaVitest 运行配置,从工具栏的 运行 小组件中选择它,点击其旁边的 更多操作图标 ,并从列表中选择 使用覆盖率运行“<configuration name>”

    使用覆盖率启动测试运行/调试配置
  • 或者,使用边距中的测试图标快速运行特定套件或带覆盖率的测试:

    在编辑器中使用覆盖率运行 Karma 测试

覆盖率套件

特定运行的覆盖率数据集合称为 coverage suite

WebStorm 可以同时显示一个或多个覆盖率套件的结果。 如果选择了多个套件,则 IDE 会显示这些套件的合并结果。 这意味着如果某行在多个所选套件中的至少一个中被执行,则视为已覆盖。

相关套件文件位于 WebStorm 的系统目录中:

%LOCALAPPDATA%\JetBrains\WebStorm2025.2\coverage

~/.cache/JetBrains/WebStorm2025.2/coverage

~/Library/Caches/JetBrains/WebStorm2025.2/coverage

管理套件

  1. 在主菜单中,依次点击 运行 | 管理覆盖率报告 Ctrl+Alt+F6

  2. 选择要显示的覆盖率方案 菜单中:

    • 使用复选框选择激活的套件。 激活的套件定义了当前在 IDE 中显示的覆盖率数据。

    • 使用 添加按钮添加 导入外部套件文件,例如从 CI 服务器中生成或由他人提供。

    • 使用 移除按钮移除 从列表中移除套件但保留其文件。

    • 使用 删除按钮删除 从列表中移除套件并从存储中删除该文件。

读取覆盖率数据

WebStorm 会在以下位置显示覆盖率结果:

  • 覆盖率 工具窗口

  • 项目 工具窗口

  • 编辑器

Coverage 工具窗口

工具窗口显示每个文件夹的覆盖率百分比以及每个文件中的覆盖率百分比。

Coverage 工具窗口

在使用覆盖率运行配置后,会立即显示 覆盖率 工具窗口,并显示覆盖率报告。 要重新打开 覆盖率 工具窗口,请在主菜单中前往 运行 | 显示代码覆盖率数据 ,或按下 Ctrl+Alt+F6

Code Coverage 工具窗口选项

覆盖率 工具窗口包含以下选项:

描述

单击导航按钮

启用此选项后,WebStorm 会自动在编辑器中打开所选项。 否则,您需要双击项目以打开。

始终选择已打开元素按钮

如果启用此选项,WebStorm 会在工具窗口中自动定位您在编辑器中打开的文件。

导入外部覆盖率报告按钮

从磁盘导入覆盖率套件。

筛选器

过滤覆盖率结果。 您可以选择仅查看包含未提交更改的文件,以关注最近的更新,或隐藏已通过测试完全覆盖的文件。

筛选器图标

编辑器中的覆盖率结果

在编辑器中打开文件时,其行将根据覆盖率状态在标尺中高亮显示:

  • 完整代码覆盖率 绿色 — 已执行的代码行

  • 完整代码覆盖率 红色 — 未执行的代码行

要查看某行被命中次数,请单击标尺中的颜色指示器。 弹出的窗口会显示光标所在行的统计信息。

编辑器中的覆盖率结果

Project 工具窗口中的覆盖率结果

项目 显示文件和目录已覆盖行的百分比。

Project 工具窗口中的覆盖率结果

隐藏覆盖率数据

执行以下操作之一:

  • 关闭 覆盖率 工具窗口中的覆盖率统计信息标签页(视图 | 工具窗口 | 覆盖率)。

  • 单击标尺中的覆盖率高亮,并选择 隐藏覆盖率

    隐藏编辑器边距中的覆盖率结果

配置代码覆盖率

  1. Ctrl+Alt+S 打开设置,然后选择 构建、执行、部署 | 覆盖率

  2. 定义如何处理收集到的覆盖率数据:

    • 要在每次使用代码覆盖率启动新的运行配置时显示 代码覆盖率 对话框,请选择 应用覆盖率到编辑器之前显示选项

    • 要丢弃新的代码覆盖率结果,请选择 不应用收集的覆盖率

    • 要在每次使用代码覆盖率启动新的运行配置时丢弃活动套件并使用新的套件,请选择 用新方案替换活动方案

    • 要在每次使用代码覆盖率启动新的运行配置时将新的覆盖率套件附加到活动套件,请选择 添加到活动方案

  3. 定义在使用覆盖率运行应用程序或测试时 覆盖率 工具窗口的行为:

    • 要自动打开 覆盖率 工具窗口,请选中 激活覆盖率视图 复选框。

    • 要手动打开 覆盖率 工具窗口,请取消选中 激活覆盖率视图 复选框。

更改覆盖率高亮显示颜色

  1. Ctrl+Alt+S 打开设置,然后选择 编辑器 | 颜色方案 | 常规

  2. 或者,单击标尺中覆盖率指示行弹出的窗口中的 编辑覆盖率颜色按钮

  3. 在组件列表中,展开 代码行覆盖率 节点并选择一种覆盖类型,例如 完全部分未覆盖

  4. 单击 前景色 字段以打开 选择颜色 对话框。

  5. 选择颜色,应用更改并关闭对话框。

配置用于表示编辑器中覆盖率状态的颜色
最后修改日期: 2025年 9月 26日