Bazel 提供了 coverage 子命令，用于针对可通过 bazel coverage 进行测试的代码库生成代码覆盖率报告。由于各种语言生态系统的特性，为给定项目完成这项工作有时并非易事。
本页介绍了创建和查看覆盖率报告的一般流程，还针对配置已知的语言提供了一些特定于语言的备注。建议您先阅读“常规”部分，然后再阅读特定语言的要求。另请注意“远程执行”部分，其中需要考虑一些其他事项。
虽然可以进行大量自定义设置，但本文档重点介绍如何生成和使用 lcov 报告，这是目前支持最广泛的途径。
创建覆盖率报告
准备工作
创建覆盖率报告的基本工作流程需要以下各项：
- 包含测试目标的基本代码库
- 安装了特定于语言的代码覆盖率工具的工具链
- 正确的“插桩”配置
前两种方法因语言而异，并且大多很简单，但对于复杂的项目，后一种方法可能更难。
这里的“插桩”是指用于特定目标的覆盖率工具。Bazel 允许使用 --instrumentation_filter 标志为特定的文件子集启用此功能，此标志为在启用插桩的情况下测试的目标指定了过滤条件。如需为测试启用插桩，必须使用 --instrument_test_targets 标志。
默认情况下，bazel 会尝试匹配目标软件包，并将相关过滤条件输出为 INFO 消息。
运行覆盖率
如需生成覆盖率报告，请使用 bazel coverage
--combined_report=lcov
[target]。这会为目标运行测试，并为每个文件生成 lcov 格式的覆盖率报告。
完成后，bazel 会运行一个操作来收集所有生成的覆盖率文件，并将它们合并为一个文件，该文件最终会在 $(bazel info
output_path)/_coverage/_coverage_report.dat 下创建。
如果测试失败，系统也会生成覆盖率报告，但请注意，这不适用于失败的测试，系统只会报告通过的测试。
查看报道
覆盖率报告仅以不直观的 lcov 格式输出。由此，我们可以使用 genhtml 实用程序（lcov 项目的一部分）生成可在网络浏览器中查看的报告：
genhtml --branch-coverage --output genhtml "$(bazel info output_path)/_coverage/_coverage_report.dat"
请注意，genhtml 还会读取源代码，以注释这些文件中缺少的覆盖率。为此，genhtml 应在 bazel 项目的根目录中执行。
如需查看结果，只需在任意网络浏览器中打开 genhtml 目录中生成的 index.html 文件即可。
如需有关 genhtml 工具或 lcov 覆盖率格式的更多帮助和信息，请参阅 lcov 项目。
远程执行
使用远程测试作业运行目前存在一些注意事项：
- 报告组合操作尚无法远程运行。这是因为 Bazel 不会将覆盖率输出文件视为其图的一部分（请参阅此问题），因此无法正确将其视为组合操作的输入。如需解决此问题，请使用
--strategy=CoverageReport=local。- 注意：由于 Bazel 解析策略的方式，如果将 Bazel 设置为试用
local,remote，则可能需要指定类似--strategy=CoverageReport=local,remote的内容。
- 注意：由于 Bazel 解析策略的方式，如果将 Bazel 设置为试用
- 由于前者，也无法使用
--remote_download_minimal和类似标志。 - 如果测试之前已缓存，Bazel 目前将无法创建覆盖率信息。为解决此问题，可以专门针对覆盖率运行设置
--nocache_test_results，但这当然会在测试时间方面造成巨大开销。 --experimental_split_coverage_postprocessing和--experimental_fetch_all_coverage_outputs- 覆盖率通常是作为测试操作的一部分运行，因此默认情况下，我们不会将所有覆盖率返回为远程执行的输出。这些标志会替换默认标志并获取覆盖率数据。如需了解详情，请参阅此问题。
特定于语言的配置
Java
Java 应在默认配置下开箱即用。bazel 工具链包含远程执行所需的一切，包括 JUnit。
Python
如需了解在 Python 中启用代码覆盖率支持所需的其他步骤，请参阅 rules_python 代码覆盖率文档。