Bazel 標記一覽表

瀏覽 Bazel 的大量指令列標記清單可能相當困難。本頁將著重於說明您必須瞭解的最重要標記。

提示：選取表格中的旗標名稱，即可前往指令列參考資料中的項目。

實用的一般選項

下列標記應在指令列中明確設定。

檢舉	說明
--config	您可以將 .bazelrc 檔案中的標記整理成設定，例如用於偵錯或發布版本的設定。您可以使用 --config=<group> 選取其他配置群組。
--keep_going	Bazel 應盡可能繼續執行建構和測試。根據預設，Bazel 會立即失敗。
--remote_download_outputs	使用遠端執行或快取 (磁碟和遠端) 時，您可以向 Bazel 發出信號，表示您要下載「所有」 (中繼) 建構構件，如下所示： --remote_download_outputs=all 根據預設，Bazel 只會下載頂層構件，例如最終二進位檔，以及本機動作所需的中繼構件。
--stamp	將建構資訊 (使用者、時間戳記) 新增至二進位檔。 注意：由於這會增加建構時間，因此僅適用於發布版本的建構作業。

找出建構和測試問題

下列標記可協助您進一步瞭解 Bazel 建構或測試錯誤。

檢舉	說明
--announce_rc	顯示透過使用者定義、機器定義或專案定義的 .bazelrc 檔案隱含設定的標記。
--auto_output_filter	根據預設，Bazel 會嘗試避免記錄垃圾訊息，並只針對在指令線上要求的套件和子套件，列印編譯器警告和 Starlark 偵錯輸出內容。如要停用所有篩選功能，請設定 --auto_output_filter=none。
--sandbox_debug	可讓您深入瞭解沙箱模式錯誤。如要進一步瞭解 Bazel 為何預設會將建構作業置入沙箱，以及哪些項目會置入沙箱，請參閱沙箱說明文件。 提示：如果您認為錯誤可能是沙箱機制造成的，請嘗試暫時關閉沙箱機制。 如要這麼做，請將 --spawn_strategy=standalone 新增至指令。
--subcommands (-s)	無論是成功或失敗，都會顯示 Bazel 在建構期間執行的所有指令的完整清單

啟動

注意： 啟動旗標必須在指令前傳遞，才能導致伺服器重新啟動。請謹慎切換這些標記。

檢舉	說明
--bazelrc	您可以在 .bazelrc 檔案中指定預設的 Bazel 選項。如果有多個 .bazelrc 檔案，您可以新增 --bazelrc=<path to the .bazelrc file> 來選取要使用的 .bazelrc 檔案。 提示： --bazelrc=dev/null 會停用 .bazelrc 檔案的搜尋功能。 在您想確保清理建構環境 (例如發布子版本) 的情況下，這會是理想做法，可避免 .bazelrc 檔案發生任何非預期的設定變更
--host_jvm_args	限制 Bazel 伺服器使用的 RAM 用量。舉例來說，以下指令會將 Bazel 堆積大小限制為 3GB： --host_jvm_args=-Xmx3g 注意： -Xmx 可用於設定 Java 虛擬機器 (JVM) 的堆積大小上限。堆積是物件分配所在的記憶體區域。這個選項的正確格式為 -Xmx<size>，其中 <size> 是最大堆積大小，以以下單位指定： m 代表 MB g 代表 GB k 代表千位元組
--output_base	控制 Bazel 的輸出樹狀結構。Bazel 不會在原始碼樹狀結構中儲存建構輸出內容 (包括記錄檔)。而是使用專屬的輸出樹狀結構。 提示：在一個 Bazel 工作區中使用多個輸出基地，可讓您同時執行多個 Bazel 伺服器。這在嘗試避免分析衝突時，可能會很實用。詳情請參閱「選擇輸出基準」一文。

Bazel 測試

下列旗標與 Bazel 測試相關

檢舉	說明
--java_debug	讓 Java 測試在執行前等待偵錯工具連線。
--runs_per_test	執行測試的次數。舉例來說，如要執行 N 次測試，請新增 --runs_per_test=N。這對於偵錯不穩定的測試，以及查看修正內容是否會導致測試一律通過，都相當實用。
--test_filter	在重複執行單一測試方法時，這項旗標特別實用，例如當您所做的變更導致測試失敗時。您可以專注於失敗的特定測試，而不需要重新執行測試套件中的所有測試方法。這可讓您更快獲得意見回饋，並更有效率地進行偵錯。這個標記通常會與 --test_output=streamed 搭配使用，用於即時測試輸出。
--test_output	指定輸出模式。根據預設，Bazel 會在本機記錄檔中擷取測試輸出內容。當您對失敗的測試進行疊代時，通常會使用 --test_output=streamed 即時查看測試輸出內容。

Bazel 執行

下列標記與 Bazel 執行作業相關。

檢舉	說明
--run_under	變更可執行檔的叫用方式。例如 --run_under="strace -c" 通常用於偵錯。

使用者專屬的 bazelrc 選項

下列標記與使用者專屬的 .bazelrc 選項相關。

檢舉	說明
--disk_cache	路徑指向 Bazel 可讀取及寫入動作和動作輸出內容的目錄。如果目錄不存在，系統會建立該目錄。您可以在多個分支或工作區之間共用建構成果，並在指令中加入 --disk_cache=<path>，加快 Bazel 建構作業。
--jobs	要執行的並行工作數量。只有在使用遠端執行功能時，才需要執行這項操作，因為在這種情況下，遠端建構叢集會執行比本機核心更多的工作。
--local_resources	限制本機執行動作所需的 CPU 或 RAM 用量。 注意：這不會影響 Bazel 伺服器本身在分析和建構協調等工作中所需的 CPU 或 RAM 數量。
--sandbox_base	讓沙箱在這個路徑下方建立沙箱目錄。根據預設，Bazel 會執行本機動作沙箱，這會為建構作業增加一些額外負擔。 提示：在 tmpfs 上指定路徑 (例如 /run/shm)，可能會在建構或測試時大量輸入檔案時，大幅提升效能。

專案專屬的 bazelrc 選項

下列標記與專案專屬的 .bazelrc 選項相關。

檢舉	說明
--flaky_test_attempts	在任何測試失敗的情況下，重試各項測試的次數上限為指定次數。這在持續整合作業中特別實用。需要多次嘗試才能通過的測試，會在測試摘要中標示為「FLAKY」FLAKY。
--remote_cache	快取端點的 URI。設定遠端快取是加快 Bazel 建構作業的好方法。可搭配本機磁碟快取使用。
--remote_download_regex	強制下載路徑符合此模式的遠端建構輸出內容，不受 --remote_download_outputs 設定影響。您可以重複使用這個旗標來指定多個模式。
--remote_executor	遠端執行端點的 HOST 或 HOST:PORT。如果您使用遠端執行服務，請傳遞這個值。您通常需要新增 --remote_instance_name=<name>。
--remote_instance_name	在遠端執行 API 中以 instance_name 形式傳遞的值。
--show-timestamps	如果指定時間戳記，系統會在 Bazel 產生的每則訊息中加入時間戳記，指定訊息顯示的時間。這對 CI 系統來說非常實用，可讓您快速瞭解哪個步驟花費了多少時間。
--spawn_strategy	即使使用遠端執行作業，在本機執行某些建構動作可能會更快。這取決於建構叢集的容量、網路速度和網路延遲等因素。 提示：如要在本機和遠端執行動作，並接受更快速的結果，請將 --spawn_strategy=dynamic 新增至建構指令。