最佳化記憶體

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

使用有限的 RAM 執行 Bazel

在某些情況下,您可能會希望 Bazel 使用最少的記憶體。您可以透過啟動旗標 --host_jvm_args 設定最大堆積,例如 --host_jvm_args=-Xmx2g

不過,如果建構作業夠大,Bazel 可能會在記憶體不足時擲回 OutOfMemoryError (OOM)。您可以傳遞下列指令標記,讓 Bazel 使用較少的記憶體,但增量建構作業會變慢:--discard_analysis_cache--nokeep_state_after_build--notrack_incremental_state

這些標記會盡量減少 Bazel 在建構作業中使用的記憶體,但代價是未來的建構作業會比標準的累加建構作業慢。

你也可以個別傳遞其中任一標記:

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

記憶體用量分析

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