本页面介绍了在 Windows 上安装 Bazel 的要求和步骤。 此外,还介绍了问题排查以及安装 Bazel 的其他方式,例如 使用 Chocolatey 或 Scoop。
安装 Bazel
本部分介绍了在 Windows 上安装期间的前提条件、环境设置和详细 步骤。
检查您的系统
建议:64 位 Windows 10,版本 1703(创意者更新)或更高版本
如需检查您的 Windows 版本,请执行以下操作:
- 点击“开始”按钮。
- 在搜索框中输入
winver,然后按 Enter 键。 - 您应该会看到“关于 Windows”框,其中包含您的 Windows 版本信息。
安装必要工具
下载 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接下来,您可以在此处查看更多提示和指南:
安装编译器和语言运行时
根据您要构建的语言,您需要:
-
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环境变量。-
您需要此工具才能在 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。
如果这没有帮助,请执行以下操作:
依次前往“开始”菜单 >“设置”。
找到“修改账号的环境变量”设置
查看顶部的列表(“<username> 的用户变量”),然后点击下方的“新建…” 按钮。
对于“变量名称”,输入
BAZEL_SH点击“浏览文件…”
导航到 MSYS2 目录,然后导航到其下方的
usr\bin。例如,这可能是您系统上的
C:\msys64\usr\bin。选择
bash.exe或bash文件,然后点击“确定”“变量值”字段现在包含
bash.exe的路径。点击“确定”以关闭窗口。完成。
如果您打开新的 cmd.exe 或 PowerShell 终端并立即运行 Bazel,它将找到 Bash。
Bazel 找不到 Visual Studio 或 Visual C++
可能的原因:
您安装了多个版本的 Visual Studio
您安装并移除了各种版本的 Visual Studio
您安装了各种版本的 Windows SDK
您安装 Visual Studio 时未采用默认安装路径
解决方案:
依次前往“开始”菜单 >“设置”。
找到“修改账号的环境变量”设置
查看顶部的列表(“<username> 的用户变量”),然后点击下方的“新建…” 按钮。
对于“变量名称”,输入
BAZEL_VC点击“浏览目录…”
导航到 Visual Studio 的
VC目录。例如,这可能是
C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC您系统上的。选择
VC文件夹,然后点击“确定”“变量值”字段现在包含
VC的路径。点击“确定”以关闭窗口。完成。
如果您打开新的 cmd.exe 或 PowerShell 终端并立即运行 Bazel,它将找到 Visual C++。
安装 Bazel 的其他方式
使用 Chocolatey
安装 Chocolatey 软件包管理器
安装 Bazel 软件包:
choco install bazel此命令将安装最新可用的 Bazel 版本以及 其依赖项,例如 MSYS2 shell。不过,此命令不会安装 Visual C++ 。
如需详细了解 Chocolatey 软件包,请参阅 Chocolatey 安装和软件包维护 指南。
使用 Scoop
使用以下 PowerShell 命令安装 Scoop 软件包管理器:
iex (new-object net.webclient).downloadstring('https://get.scoop.sh')安装 Bazel 软件包:
scoop install bazel
如需详细了解 Scoop 软件包,请参阅 Scoop 安装和软件包维护 指南。
从源代码构建
如需从头开始构建 Bazel 而不是安装,请参阅从源代码编译。