在 Windows 上安裝 Bazel

回報問題open_in_new 查看來源open_in_new

本頁面說明在 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)。
• 從巧克力安裝 Bazel
• 從 Scoop 安裝 Bazel
• 從來源建構 Bazel

設定環境

如要將 Bazel 預設為可透過指令提示或 PowerShell 輕鬆存取，您可以將 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 找不到 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

• Windows x86-64 適用的 Python 3.6

  您需要使用這組憑證，才能在 Windows 上建構 Python 程式碼。

  也支援：Windows x86-64 適用的 Python 2.7 以上版本

疑難排解

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++。

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

使用 Scoop

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

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

2. 安裝 Bazel 套件：

   scoop install bazel
   

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

從來源建構

如要從頭開始建構 Bazel，而非安裝，請參閱從來源編譯。