跨平台开发 / 系统课时
生成并读取测试覆盖率报告
生成并读取测试覆盖率报告
覆盖率报告的价值不在于得到一个百分比,而在于回答“哪些可执行代码从未被测试走到”。本节使用 Dart 的 coverage 工具生成 LCOV 报告,再从文件级与行级数据定位未覆盖代码。
学习目标
- 为 Dart 测试执行采集覆盖率并生成
coverage/lcov.info - 读懂 LCOV 中
SF、DA、LF、LH等关键记录 - 根据零命中行定位需要补测试的代码位置
准备覆盖率工具
在普通 Dart package 根目录执行下面的 Bash 命令,把 test 和 coverage 加入开发依赖。Pub 会自动选择与当前 SDK 约束兼容的稳定版本,因此无需把课程示例固定在某个补丁版本。
dart pub add dev:test dev:coverage >/dev/null && echo "coverage dependencies ready"预期输出:
coverage dependencies ready如果项目已经声明这两个开发依赖,可以直接进入覆盖率采集。Flutter 项目应使用 Flutter 对应的测试覆盖率流程,本节聚焦 Dart package。
生成 LCOV 报告
coverage:test_with_coverage 会运行测试、通过 Dart VM Service 收集执行信息,并在默认的 coverage/ 目录生成原始覆盖率数据和 lcov.info。下面的命令在测试成功且文件确实生成后才打印确认信息。
dart run coverage:test_with_coverage >/dev/null && test -f coverage/lcov.info && echo "coverage/lcov.info ready"预期输出:
coverage/lcov.info ready若命令没有打印确认信息,应先直接运行 dart test 排除测试失败,再检查依赖解析和当前工作目录。不要把“没有报告”误判成“覆盖率为 0”。
读懂行覆盖记录
LCOV 按源文件保存记录。下面是片段示例,用于说明字段含义,不代表某个真实项目的固定行号。
SF:lib/price.dart
DA:8,3
DA:12,0
LF:2
LH:1
end_of_recordSF 表示源文件;DA:<行号>,<执行次数> 表示该行被记录的命中次数,所以 DA:12,0 直接指出第 12 行从未执行。LF 是报告中的可覆盖行数,LH 是至少命中过一次的行数。这个片段的行覆盖率为 1 / 2 = 50%。
覆盖率不是“每一行源码都必须出现”。空行、注释和部分声明本身不是可执行语句,通常不会按普通执行行计入 LF。因此应以报告中的记录为准,而不是用源码总行数自行计算。
列出零命中行
在 macOS、Linux 或提供 awk 的环境中,可以直接从 LCOV 中提取未覆盖行。命令会记住当前 SF 文件,并输出命中次数为 0 的 DA 行。
awk -F'[:,]' '/^SF:/{file=substr($0,4)} /^DA:[0-9]+,0$/{print file ":" $2}' coverage/lcov.info预期结果(项目存在未覆盖行时):
<PATH>:<LINE>
<PATH>:<LINE><PATH> 和 <LINE> 会随项目实际源码变化。拿到位置后,应回到源码判断它属于正常业务路径、异常处理、边界条件还是不可达代码,再决定补测试还是调整实现。