本頁面說明如何在 macOS 上安裝 Bazel 並設定環境。
您可以使用下列任一方法在 macOS 上安裝 Bazel：
Bazel 提供兩個完成指令碼。安裝 Bazel 後，您可以執行下列操作：
- 存取 bash 完成指令碼
- 安裝 zsh 完成指令碼
使用 Homebrew 進行安裝
步驟 1：在 macOS 上安裝 Homebrew
安裝 Homebrew (一次性步驟)：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
步驟 2：透過 Homebrew 安裝 Bazel
透過 Homebrew 安裝 Bazel 套件，如下所示：
brew install bazel
一切就緒！您可以執行下列指令，確認 Bazel 已成功安裝：
bazel --version
安裝完成後，您可以使用下列指令升級至新版 Bazel：
brew upgrade bazel
使用二進位安裝程式進行安裝
二進位安裝程式位於 Bazel 的 GitHub 版本頁面。
安裝程式包含 Bazel 二進位檔。您必須安裝部分額外程式庫，才能讓 Bazel 運作。
步驟 1：安裝 Xcode 指令列工具
如果您不打算使用 ios_* 規則，只要使用 xcode-select 安裝 Xcode 指令列工具套件即可：
xcode-select --install
否則，如要支援 ios_* 規則，您必須在系統上安裝 Xcode 6.1 以上版本，並安裝 iOS SDK 8.1。
從 App Store 或 Apple Developer 網站下載 Xcode。
安裝 Xcode 後，請使用下列指令接受所有使用者的授權協議：
sudo xcodebuild -license accept
步驟 2：下載 Bazel 安裝程式
接著，請從 GitHub 上的 Bazel 版本頁面下載名為 bazel-<version>-installer-darwin-x86_64.sh 的 Bazel 二進位安裝程式。
在 macOS Catalina 以上版本 (macOS 11 以上)，由於 Apple 的新應用程式簽署規定，您必須使用 curl 從終端機下載安裝程式，並將版本變數替換為要下載的 Bazel 版本：
export BAZEL_VERSION=5.2.0curl -fLO "https://github.com/bazelbuild/bazel/releases/download/$BAZEL_VERSION/bazel-$BAZEL_VERSION-installer-darwin-x86_64.sh"
在 macOS 發布流程支援簽署功能之前，這是暫時的解決方法 (#9304)。
步驟 3：執行安裝程式
執行 Bazel 安裝程式，如下所示：
chmod +x "bazel-$BAZEL_VERSION-installer-darwin-x86_64.sh"./bazel-$BAZEL_VERSION-installer-darwin-x86_64.sh --user
--user 標記會將 Bazel 安裝到系統上的 $HOME/bin 目錄，並將 .bazelrc 路徑設為 $HOME/.bazelrc。使用 --help 指令查看其他安裝選項。
如果您使用的是 macOS Catalina 或以上版本 (macOS 11 以上)，且收到「無法開啟 'bazel-real'，因為無法驗證開發人員」錯誤訊息，則必須使用 curl 從終端重新下載安裝程式，做為暫時解決方法；請參閱上方的步驟 2。
步驟 4：設定環境
如果您使用上述 --user 標記執行 Bazel 安裝程式，Bazel 執行檔會安裝在 HOME/bin 目錄中。建議您將這個目錄新增至預設路徑，如下所示：
export PATH="PATH:HOME/bin"
您也可以將這項指令加入 ~/.bashrc、~/.zshrc 或 ~/.profile 檔案。
一切就緒！您可以執行下列指令，確認 Bazel 已成功安裝：
bazel --version
如要更新為較新的 Bazel 版本，請下載並安裝所需版本。