跨平台开发 / 系统课时

生成并读取测试覆盖率报告

生成并读取测试覆盖率报告

覆盖率报告的价值不在于得到一个百分比,而在于回答“哪些可执行代码从未被测试走到”。本节使用 Dart 的 coverage 工具生成 LCOV 报告,再从文件级与行级数据定位未覆盖代码。

学习目标

  • 为 Dart 测试执行采集覆盖率并生成 coverage/lcov.info
  • 读懂 LCOV 中 SF、DA、LF、LH 等关键记录
  • 根据零命中行定位需要补测试的代码位置

准备覆盖率工具

在普通 Dart package 根目录执行下面的 Bash 命令,把 test 和 coverage 加入开发依赖。Pub 会自动选择与当前 SDK 约束兼容的稳定版本,因此无需把课程示例固定在某个补丁版本。

bash
dart pub add dev:test dev:coverage >/dev/null && echo "coverage dependencies ready"

预期输出:

text
coverage dependencies ready

如果项目已经声明这两个开发依赖,可以直接进入覆盖率采集。Flutter 项目应使用 Flutter 对应的测试覆盖率流程,本节聚焦 Dart package。

生成 LCOV 报告

coverage:test_with_coverage 会运行测试、通过 Dart VM Service 收集执行信息,并在默认的 coverage/ 目录生成原始覆盖率数据和 lcov.info。下面的命令在测试成功且文件确实生成后才打印确认信息。

bash
dart run coverage:test_with_coverage >/dev/null && test -f coverage/lcov.info && echo "coverage/lcov.info ready"

预期输出:

text
coverage/lcov.info ready

若命令没有打印确认信息,应先直接运行 dart test 排除测试失败,再检查依赖解析和当前工作目录。不要把“没有报告”误判成“覆盖率为 0”。

读懂行覆盖记录

LCOV 按源文件保存记录。下面是片段示例,用于说明字段含义,不代表某个真实项目的固定行号。

text
SF:lib/price.dart
DA:8,3
DA:12,0
LF:2
LH:1
end_of_record

SF 表示源文件;DA:<行号>,<执行次数> 表示该行被记录的命中次数,所以 DA:12,0 直接指出第 12 行从未执行。LF 是报告中的可覆盖行数,LH 是至少命中过一次的行数。这个片段的行覆盖率为 1 / 2 = 50%。

覆盖率不是“每一行源码都必须出现”。空行、注释和部分声明本身不是可执行语句,通常不会按普通执行行计入 LF。因此应以报告中的记录为准,而不是用源码总行数自行计算。

列出零命中行

在 macOS、Linux 或提供 awk 的环境中,可以直接从 LCOV 中提取未覆盖行。命令会记住当前 SF 文件,并输出命中次数为 0 的 DA 行。

bash
awk -F'[:,]' '/^SF:/{file=substr($0,4)} /^DA:[0-9]+,0$/{print file ":" $2}' coverage/lcov.info

预期结果(项目存在未覆盖行时):

text
<PATH>:<LINE>
<PATH>:<LINE>

<PATH> 和 <LINE> 会随项目实际源码变化。拿到位置后,应回到源码判断它属于正常业务路径、异常处理、边界条件还是不可达代码,再决定补测试还是调整实现。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

生成并读取测试覆盖率报告

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通