最佳化記憶體

回報問題 查看來源

本頁面說明如何限制及減少 Bazel 使用的記憶體。

以有限的 RAM 執行 Bazel

在某些情況下,您可能會想讓 Bazel 使用最小的記憶體。您可以透過啟動標記 --host_jvm_args (例如 --host_jvm_args=-Xmx2g) 設定堆積上限。

然而,如果您的建構大小夠大,Bazel 可能會在記憶體不足時擲回 OutOfMemoryError (OOM)。您可以傳送 --discard_analysis_cache--nokeep_state_after_build--notrack_incremental_state 等指令標記,以降低 Bazel 使用的記憶體,但代價是漸進式建構作業較慢的成本。

這些標記可盡量減少 Bazel 在建構中使用的記憶體,而且日後的建構作業產生速度會比標準漸進式建構作業慢。

您也可以個別傳遞以下其中一個標記:

  • --discard_analysis_cache 會減少執行 (而非分析) 期間使用的記憶體。漸進式建構作業不必重新執行套件載入作業,但必須重新分析和執行 (不過磁碟上的動作快取可以防止大部分重新執行)。
  • --notrack_incremental_state 不會將任何邊緣儲存在 Bazel 的內部依附元件圖表中,因此無法用於漸進式建構作業。下一個版本會捨棄這些資料,但除非指定 --nokeep_state_after_build,否則系統會保留資料供內部偵錯使用。
  • --nokeep_state_after_build 會在建構後捨棄所有資料,因此漸進式建構作業必須從頭開始建構 (磁碟上動作快取除外)。這不會影響目前版本的高水標記。

記憶體分析

Bazel 內建的記憶體分析器可協助您檢查規則的記憶體使用情況。如要進一步瞭解這項程序,請參閱說明文件的記憶體剖析一節,以瞭解如何提升自訂規則的效能。