在 Windows 上安装 Bazel

<ph type="x-smartling-placeholder"></ph> 报告问题 查看来源 敬上 每晚 · 7.3。 · 7.2 条 · 7.1。 · 7.0。 · 6.5

本页面介绍了在 Windows 上安装 Bazel 的要求和步骤。 其中还包括问题排查和其他安装 Bazel 的方法，例如 比如“巧克力”或“勺子”

安装 Bazel

本部分介绍了前提条件、环境设置和详细的 安装过程中的步骤。

检查您的系统

推荐：64 位 Windows 10 版本 1703（创作者更新）或更高版本

要查看您的 Windows 版本，请执行以下操作：

  • 点击“开始”按钮。
  • 在搜索框中输入 winver，然后按 Enter 键。
  • 您应该会看到包含 Windows 版本信息的“关于 Windows”框。

还支持：

  • 64 位 Windows 7 或更高版本

  • 64 位 Windows Server 2008 R2 或更高版本

安装必备项

下载 Bazel

建议：使用 Bazelisk

或者，您也可以：

设置环境

为了在默认情况下让用户能够通过命令提示符或 PowerShell 轻松访问 Bazel，您可以将 Bazel 二进制文件重命名为 bazel.exe，并将其添加到默认路径。

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

您还可以更改系统 PATH 环境变量，使其永久生效。了解如何设置环境变量。

完成

“成功：您已成功安装 Bazel。”

如需检查安装是否正确，请尝试运行以下命令：

bazel version

接下来，您可以点击以下链接查看更多提示和指导：

安装编译器和语言运行时

根据要构建的语言，您将需要：

  • MSYS2 x86_64

    MSYS2 是适用于 Windows 的软件发行版和构建平台。它包含 Bash 和常用 Unix 工具（例如 grep、tar、git）。

    您将需要 MSYS2 来构建、测试或运行依赖于 Bash 的目标。通常是 genrule、sh_binary、sh_test，但也可能存在更多其他规则（例如 Starlark 规则）。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 环境变量。

  • Build Tools for Visual Studio 2019

    在 Windows 上构建 C++ 代码时需要使用此文件。

    还支持：

    • 采用 Visual C++ 和 Windows 10 SDK 的 Visual Studio 2015（或更高版本）

    • Visual C++ Build Tools 2015（或更高版本）和 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 shell。此命令不会安装 Visual C++ 。

请参阅巧克力安装和软件包维护 指南，了解更多信息 有关巧克力包装的信息。

使用 Scoop

  1. 使用以下 PowerShell 命令安装 Scoop 软件包管理器：

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

  2. 安装 Bazel 软件包：

    scoop install bazel

请参阅 Scoop 安装和软件包维护 指南，了解更多信息 Scoop 包的相关信息。

从源代码构建

要从头开始构建 Bazel，而不是安装，请参阅从源代码编译。