WebStorm 2025.3 Help

代码覆盖率

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

覆盖率测量的结果保存在 覆盖率套件 中。 您还可以将其与任何现有套件合并。 在这种情况下,如果某行至少被一次测试运行覆盖,则视为已覆盖。

代码覆盖率测量适用于 JestMochaKarmaVitest

运行测试并生成覆盖率报告

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

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

    从编辑器运行 Karma 测试,并查看覆盖率

覆盖套件

对于特定运行的覆盖数据收集称为 覆盖套件

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

对应的套件文件位于 WebStorm 的系统目录下:

%LOCALAPPDATA%\JetBrains\WebStorm2025.3\coverage

~/.cache/JetBrains/WebStorm2025.3/coverage

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

管理套件

  1. 在主菜单中,前往 运行 | 管理覆盖率报告 Ctrl+Alt+F6

  2. 选择要显示的覆盖率套件 菜单中:

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

    • 导入外部套件文件,请使用 添加按钮添加 ,例如在 CI 服务器中生成的文件或其他人发送给您的文件。

    • 请使用 "移除"按钮移除 从列表中移除套件但保留存储中的文件。

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

读取覆盖率数据

WebStorm 显示的覆盖率结果在:

  • 覆盖 工具窗口

  • 项目 工具窗口

  • 编辑器

覆盖率工具窗口

工具窗口显示每个文件夹的已覆盖代码行百分比以及每个文件的已覆盖代码行百分比。

覆盖率工具窗口

覆盖 工具窗口会在您运行带有覆盖率的配置后立即出现,并显示覆盖率报告。 要重新打开 覆盖 工具窗口,请转到主菜单中的 运行 | 显示代码覆盖率数据 ,或按 Ctrl+Alt+F6

代码覆盖率工具窗口选项

覆盖 工具窗口有以下选项:

条目

描述

点击导航按钮

如果此选项开启,WebStorm 会自动在编辑器中打开所选项目。 否则,您需要双击项目才能打开它们。

始终选择已打开元素按钮

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

导入外部覆盖率报告按钮

从磁盘导入覆盖率套件。

筛选器

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

筛选图标

编辑器中的覆盖率结果

当文件在编辑器中打开时,其代码行会根据覆盖率状态在边栏中高亮显示:

  • 全面代码覆盖率 绿色——已执行的行

  • 全部代码覆盖率 红色 – 未执行的代码行

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

编辑器中的覆盖结果

项目工具窗口中的覆盖率结果

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

项目工具窗口中的覆盖率结果

隐藏覆盖率数据

请执行以下操作之一:

  • 覆盖 工具窗口 (视图 | 工具窗口 | 覆盖率) 中关闭覆盖统计选项卡。

  • 点击页边的覆盖率高亮,然后选择 隐藏覆盖率

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

配置代码覆盖率

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

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

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

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

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

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

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

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

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

更改覆盖率高亮的颜色

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

  2. 或者,单击 编辑覆盖率颜色按钮 ,位于点击边距中的覆盖率指示线时弹出的弹窗中。

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

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

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

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