Dart/Flutter 项目需要收集测试覆盖率并生成…

在 Dart 或 Flutter 项目中自动或手动收集测试覆盖率、生成 LCOV 报告，并通过忽略指令排除指定代码。

适用场景

解决思路

1. 使用标准 Dart 测试范式组织测试套件：Dart 项目用 `package:test`，Flutter 项目用 `flutter_test`。
2. 编写 Unit Tests 验证单个函数、方法或类。
3. 编写 Component/Widget Tests 验证组件行为、布局与交互，使用 mock 对象（`package:mockito`）。
4. 编写 Integration Tests 在模拟或真实设备上验证完整应用流程。
5. 用内联注释将特定行、代码块或整个文件排除出覆盖率统计。
6. 忽略单行：`// coverage:ignore-line`。
7. 忽略代码块：`// coverage:ignore-start` 和 `// coverage:ignore-end`。
8. 忽略整个文件：`// coverage:ignore-file`。
9. 格式化时传 `--check-ignore` 标志以强制执行这些忽略指令。
10. 将 `coverage` 包添加为 `dev_dependency`，不要添加到普通 dependencies。
11. Dart 项目执行：`dart pub add dev:coverage`。
12. Flutter 项目执行：`flutter pub add dev:coverage`。
13. 使用内置 `test_with_coverage` 脚本：自动运行所有测试、从 Dart VM 收集 JSON 覆盖率数据并格式化为 LCOV 报告。
14. 执行：`dart run coverage:test_with_coverage`。
15. 若在 Dart workspace（monorepo）中，显式指定测试目录，例如 `dart run coverage:test_with_coverage -- pkgs/foo/test pkgs/bar/test`。
16. 验证项目根目录下创建了 `coverage/` 目录。
17. 确保存在 `coverage/coverage.json`（原始数据）和 `coverage/lcov.info`（格式化报告）。
18. 如果特定文件缺少覆盖率，确保它们被测试文件导入并执行；若有意排除，则添加 `// coverage:ignore-file`。
19. 如需对 VM service 细粒度控制、暂停 isolate 或需要分支/函数级覆盖率，使用手动收集工作流。
20. 运行测试并启用 VM service：暂停 isolate 退出，并在指定端口（如 8181）暴露 VM service。命令：`dart run --pause-isolates-on-exit --disable-service-auth-codes --enable-vm-service=8181 test &`。
21. 从运行中的 VM service 提取覆盖率数据并输出到 JSON 文件。命令：`dart run coverage:collect_coverage --wait-paused --uri=http://127.0.0.1:8181/ -o coverage/coverage.json --resume-isolates`。
22. 可选：追加 `--function-coverage` 和 `--branch-coverage` 获取更深层指标（要求 Dart VM 2.17.0+）。
23. 将原始 JSON 转换为标准 LCOV 格式。命令：`dart run coverage:format_coverage --packages=.dart_tool/package_config.json --lcov -i coverage/coverage.json -o coverage/lcov.info --check-ignore`。
24. 确保 `pubspec.yaml` 中 `coverage` 仅位于 `dev_dependencies` 下。
25. 对生成代码或不可测试的边界情况应用忽略指令，避免降低覆盖率分数。

适用边界 · 注意事项

• 非 Dart/Flutter 项目不适用。
• 只需要运行测试而不需要覆盖率报告时不需要此流程。
• 手动高级收集的分支/函数级覆盖率需要 Dart VM 2.17.0+，不满足时无法获取这些深层指标。