Bazel 提供 coverage 子指令，用於針對可透過 bazel coverage 測試的存放區產生程式碼涵蓋率報表。由於各種語言生態系統的慣用方法相輔相成，要針對特定專案執行這項工作並不容易。
本頁面記錄建立及查看涵蓋率報表的一般程序，並針對設定已知設定的語言提供部分特定語言的附註。建議您先詳閱一般章節，再瞭解特定語言的相關規定。另請注意遠端執行部分，且需要額外考量。
雖然已完成許多自訂作業，但本文件著重在產生及使用 lcov 報表，這是目前最受支援的路徑。
建立涵蓋率報表
準備
建立涵蓋率報表的基本工作流程如下：
- 具有測試目標的基本存放區
- 已安裝特定語言程式碼涵蓋率工具的工具鍊
- 正確的「檢測」設定
前者對於語言特定且最簡單明瞭，但後者對於複雜的專案來說可能更加困難。
在此情況下，「Instrumentation」是指用於特定目標的涵蓋範圍工具。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 --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 涵蓋範圍說明文件。