在 Windows 上安裝 Bazel

回報問題 查看來源

本頁說明在 Windows 上安裝 Bazel 的規定與步驟。還包括疑難排解和其他安裝 Bazel 的方式，例如使用 Chocolatey 或 Scoop。

安裝 Bazel

本節說明在 Windows 上安裝的必要步驟、環境設定，以及安裝期間的詳細步驟。

檢查系統

建議：64 位元 Windows 10，1703 版 (創作者更新) 或以上版本

如何查看 Windows 版本：

• 按一下「開始」按鈕。
• 在搜尋框中輸入「winver」，然後按下 Enter 鍵。
• 畫面上應該會顯示「關於 Windows」方塊，其中顯示您的 Windows 版本資訊。

安裝必要條件

• Microsoft Visual C++ 可轉散發

下載 Bazel

建議使用：使用 Bazelisk

您也可以採取以下做法：

• 從 GitHub 下載 Bazel 二進位檔 (bazel-version-windows-x86_64.exe)。
• 從 Chocolatey 安裝 Bazel
• 從 Scoop 安裝 Bazel
• 從原始碼建構 Bazel

設定環境

如要讓系統預設透過指令提示或 PowerShell 輕鬆存取 Bazel，您可以將 Bazel 二進位檔重新命名為 bazel.exe，並將其新增至預設路徑。

set PATH=%PATH%;path to the Bazel binary

您也可以將系統 PATH 環境變數變更為永久性。瞭解如何設定環境變數。

完成

「成功：您已安裝 Bazel。」

如要檢查安裝是否正確，請嘗試執行以下程式碼：

bazel version

接下來，可參閱更多提示與指引：

• 安裝編譯器和語言執行階段
• 疑難排解
• Windows 的最佳做法
• 教學課程

安裝編譯器和語言執行階段

視您想建構的語言而定，您需要：

• MSYS2 x86_64

  MSYS2 是 Windows 專用的軟體發行版本與建構平台。其中包含 Bash 和常見的 Unix 工具 (例如 grep、tar、git)。

  您需要 MSYS2 才能建立、測試或執行依附 Bash 的目標。通常為 genrule、sh_binary 和 sh_test，但可能會有更多 (例如 Starlark 規則)。如果建構目標需要 Bash，但 Bazel 找不到該目標，系統就會顯示錯誤。

• 常見 MSYS2 套件

  您可能需要建立這些資料，才能建構及執行依附於 Bash 的目標。根據預設，MSYS2 不會安裝這些工具，因此您必須手動安裝。如果專案依附於 PATH 中的 Bash 工具，就需要執行這個步驟 (例如 TensorFlow)。

  開啟 MSYS2 終端機並執行下列指令：

  pacman -S zip unzip patch diffutils git
  

  選用：如果您想透過 CMD 或 Powershell 使用 Bazel，而且仍能使用 Bash 工具，請務必將 MSYS2_INSTALL_PATH/usr/bin 新增至 PATH 環境變數。

• 2019 年 Visual Studio 建構工具

  你需要在 Windows 電腦上建立 C++ 程式碼。

  也支援：

  • Visual C++ Build Tools 2017 (或更新版本) 和 Windows 10 SDK

• Windows x64 適用的 Java SE Development Kit 11 (JDK)

  你需要在 Windows 電腦上建立 Java 程式碼。

  同時支援：Java 8、9 和 10

• Python 3.6 (Windows x86-64)

  您需要在 Windows 電腦上建立 Python 程式碼。

  同時支援：Python 2.7 或更新版本 (Windows x86-64)

疑難排解

Bazel 找不到 Bash 或 bash.exe

可能原因：

• 您安裝的 MSYS2 不在預設安裝路徑底下

• 您安裝的是 MSYS2 i686，而不是 MSYS2 x86_64

• 已安裝 MSYS，而不是 MSYS2

解決方法：

請確認您已安裝 MSYS2 x86_64。

如果問題仍無法解決，請執行下列操作：

1. 依序前往 [開始] 功能表 > [設定]。

2. 找到「編輯帳戶的環境變數」設定

3. 查看頂端的清單 (「<使用者名稱> 的使用者變數」)，然後按一下下方的「新增...」按鈕。

4. 在「變數名稱」中輸入 BAZEL_SH。

5. 按一下「瀏覽檔案...」。

6. 前往 MSYS2 目錄，然後移至該目錄下方的 usr\bin。

   舉例來說，它可能是系統中的 C:\msys64\usr\bin。

7. 選取 bash.exe 或 bash 檔案，然後按一下「OK」。

8. 「變數值」欄位現在含有前往 bash.exe 的路徑。按一下 [確定] 關閉視窗。

9. 您完成了！

   如果你開啟新的 cmd.exe 或 PowerShell 終端機，然後立即執行 Bazel，找到的 Bash 就會達成目標。

Bazel 找不到 Visual Studio 或 Visual C++

可能原因：

• 假設您安裝了多個版本的 Visual Studio

• 您安裝及移除了各種版本的 Visual Studio

• 您安裝多種版本的 Windows SDK

• 您安裝 Visual Studio 時不是預設安裝路徑

解決方法：

1. 依序前往 [開始] 功能表 > [設定]。

2. 找到「編輯帳戶的環境變數」設定

3. 查看頂端的清單 (「<使用者名稱> 的使用者變數」)，然後按一下下方的「新增...」按鈕。

4. 在「變數名稱」中輸入 BAZEL_VC。

5. 按一下「瀏覽目錄...」

6. 前往 Visual Studio 的 VC 目錄。

   例如，可能是系統中的 C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC。

7. 選取 VC 資料夾，然後按一下「OK」

8. 「變數值」欄位現在含有前往 VC 的路徑。按一下 [確定] 關閉視窗。

9. 您完成了！

   如果你開啟新的 cmd.exe 或 PowerShell 終端機，然後立即執行 Bazel，找到的元件就會找到 Visual C++。

其他安裝 Bazel 的方式

使用巧克力

1. 安裝 Chocolatey 套件管理員

2. 安裝 Bazel 套件：

   choco install bazel
   

   這個指令會安裝最新可用的 Bazel 版本及其依附元件，例如 MSYS2 殼層。但無法安裝 Visual C++。

如要進一步瞭解 Chocolatey 套件，請參閱 Chocolatey 安裝及套件維護指南。

使用 Scoop

1. 使用下列 PowerShell 指令安裝 Scoop 套件管理員：

   iex (new-object net.webclient).downloadstring('https://get.scoop.sh')
   

2. 安裝 Bazel 套件：

   scoop install bazel
   

如要進一步瞭解 Scoop 套件，請參閱 Scoop 安裝及套件維護指南。

從原始碼開始建構

如果您要從頭開始建構 Bazel，而非安裝，請參閱「從原始碼編譯」。