BazelCon 2024 报名现已开放！

此页面由 Cloud Translation API 翻译。

从源代码编译 Bazel

7.3 · 7.2 · 7.1 · 7.0 · 6.5

本页面介绍了如何从源代码安装 Bazel，并提供了针对常见问题的问题排查提示。

如需从源代码构建 Bazel，您可以执行以下任一操作：

使用现有的 Bazel 二进制文件构建
在不使用现有 Bazel 二进制文件的情况下构建它，这称为引导。

使用 Bazel 构建 Bazel

摘要

从 GitHub 版本页面或使用 Bazelisk 获取最新版 Bazel。
从 GitHub 下载 Bazel 的源代码并解压缩。或者，您也可以从 https://github.com/bazelbuild/bazel 通过 git 克隆源代码树
安装与引导相同的前提条件（请参阅类似 Unix 的系统或 Windows）
使用 Bazel 构建 Bazel 的开发 build：bazel build //src:bazel-dev（在 Windows 上为 bazel build //src:bazel-dev.exe）
生成的二进制文件位于 bazel-bin/src/bazel-dev（在 Windows 上为 bazel-bin\src\bazel-dev.exe）。您可以将其复制到任何位置，并立即使用，无需进一步安装。

详细说明如下。

第 1 步：获取最新的 Bazel 版本

目标：安装或下载 Bazel 的发布版本。确保您可以在终端中输入 bazel 来运行它。

原因：要从 GitHub 源代码树构建 Bazel，您需要一个现有的 Bazel 二进制文件。您可以通过软件包管理器安装一个，也可以从 GitHub 下载一个。请参阅安装 Bazel。（或者，您也可以从头开始构建（引导）。）

问题排查：

如果您无法在终端中输入 bazel 来运行 Bazel：
- 也许 Bazel 二进制文件的目录不在 PATH 上。
  
  这不是一个大问题。您需要输入完整路径，而不是输入 bazel。
- Bazel 二进制文件本身可能未命名为 bazel（在 Unix 上）或 bazel.exe（在 Windows 上）。
  
  这不是什么大问题。您可以重命名二进制文件，也可以输入二进制文件的名称（而不是 bazel）。
- 二进制文件可能不可执行（在 Unix 上）。
  
  您必须运行 chmod +x /path/to/bazel，将该二进制文件设为可执行文件。

第 2 步：从 GitHub 下载 Bazel 的源代码

如果您熟悉 Git，则只需 git clone https://github.com/bazelbuild/bazel

否则：

下载最新的源代码（ZIP 文件）。
将内容提取到某处。

例如，在主目录下创建一个 bazel-src 目录并解压缩。

第 3 步：安装必备项

安装与引导时相同的预先条件（见下文）- JDK、C++ 编译器、MSYS2（如果您是在 Windows 上构建）等。

第 4a 步：在 Ubuntu Linux、macOS 和其他类似 Unix 的系统上构建 Bazel

如需了解适用于 Windows 的说明，请参阅在 Windows 上构建 Bazel。

目标：运行 Bazel 来构建自定义 Bazel 二进制文件 (bazel-bin/src/bazel-dev)。

说明：

启动 Bash 终端
cd 到提取（或克隆）Bazel 来源的目录中。

例如，如果您提取了主目录下的源代码，请运行以下命令：
```
cd ~/bazel-src
```
从源代码构建 Bazel：
```
bazel build //src:bazel-dev
```
或者，您也可以运行 bazel build //src:bazel --compilation_mode=opt 以生成较小的二进制文件，但构建速度会较慢。
输出将位于 bazel-bin/src/bazel-dev（或 bazel-bin/src/bazel）。

第 4b 步：在 Windows 上构建 Bazel

如需了解适用于类 Unix 系统的说明，请参阅 Ubuntu Linux、macOS 和其他类 Unix 系统。

目标：运行 Bazel 以构建自定义 Bazel 二进制文件 (bazel-bin\src\bazel-dev.exe)。

说明：

启动命令提示符（“开始”菜单 >“运行”>“cmd.exe”）
cd 到提取（或克隆）Bazel 来源的目录中。

例如，如果您提取了主目录下的源代码，请运行以下命令：
```
cd %USERPROFILE%\bazel-src
```
从源代码构建 Bazel：
```
bazel build //src:bazel-dev.exe
```
或者，您也可以运行 bazel build //src:bazel.exe --compilation_mode=opt 来生成较小的二进制文件，但构建速度会变慢。
输出将位于 bazel-bin\src\bazel-dev.exe（或 bazel-bin\src\bazel.exe）中。

第 5 步：安装构建的二进制文件

实际上，您无需安装任何内容。

上一步的输出是一个独立的 Bazel 二进制文件。您可以将其复制到任何目录并立即使用。（如果该目录位于您的 PATH 中，则非常有用，这样您就可以在任何位置运行“bazel”）。

从头开始构建 Bazel（引导）

您还可以从头开始构建 Bazel，而无需使用现有的 Bazel 二进制文件。

第 1 步：下载 Bazel 的源代码（发行归档文件）

（此步骤在所有平台上都是相同的。）

从 GitHub 下载 bazel-<version>-dist.zip，例如 bazel-0.28.1-dist.zip。

注意：
- 有一个单个的架构无关的发行归档文件。没有特定于架构或操作系统的分发归档文件。
- 这些源代码与 GitHub 源代码树不同。您必须使用分发归档文件来引导 Bazel。您不能使用从 GitHub 克隆的源代码树。（发行归档文件包含引导所需的生成源文件，这些文件不是常规 Git 源代码树的一部分。）
将分发归档解压缩到磁盘上的某个位置。

您应验证 Bazel 的发布密钥 3D5919B448457EE0 签名。

第 2a 步：在 Ubuntu Linux、macOS 和其他类似 Unix 的系统上启动 Bazel

如需了解适用于 Windows 的说明，请参阅在 Windows 上引导 Bazel。

2.1. 安装必备组件

Bash
zip、unzip
C++ build 工具链
JDK。需要版本 21。
Python。支持版本 2 和 3，只需安装其中一个版本即可。

例如，在 Ubuntu Linux 上，您可以使用以下命令安装这些要求：

sudo apt-get install build-essential openjdk-21-jdk python zip unzip

2.2. 在 Unix 上引导 Bazel

打开 shell 或终端窗口。
cd 到您解压缩发行版归档文件的目录。
运行编译脚本：env EXTRA_BAZEL_ARGS="--tool_java_runtime_version=local_jdk" bash ./compile.sh。

将编译的输出置于 output/bazel 中。这是一个独立的 Bazel 二进制文件，没有嵌入式 JDK。您可以将其复制到任何位置或就地使用。为方便起见，请将此二进制文件复制到 PATH 上的某个目录（例如 Linux 上的 /usr/local/bin）。

如需以可重现的方式构建 bazel 二进制文件，还应在“运行编译脚本”步骤中设置 SOURCE_DATE_EPOCH。

第 2b 步：在 Windows 上引导 Bazel

如需了解类似 Unix 的系统的说明，请参阅在 Ubuntu Linux、macOS 和其他类似 Unix 的系统上引导 Bazel。

2.1. 安装必备组件

MSYS2 shell
用于压缩和解压缩的 MSYS2 软件包。在 MSYS2 shell 中运行以下命令：
```
pacman -S zip unzip patch
```
Visual C++ 编译器。在 Visual Studio 2015 或更高版本中安装 Visual C++ 编译器，或者安装最新的 Build Tools for Visual Studio 2017。
JDK。必须使用版本 21。
Python。支持版本 2 和 3，安装其中之一就够了。您需要 Windows 原生版本（可从 https://www.python.org 下载）。在 MSYS2 中通过 pacman 安装的版本无法使用。

2.2. 在 Windows 上引导 Bazel

打开 MSYS2 shell。
设置以下环境变量：
- BAZEL_VS 或 BAZEL_VC（二者不相同）：设置为 Visual Studio 目录 (BAZEL_VS) 或 Visual C++ 目录 (BAZEL_VC) 的路径。设置其中一个就足够了。
- BAZEL_SH：MSYS2 bash.exe 的路径。请参阅以下示例中的命令。
  
  请勿将其设为 C:\Windows\System32\bash.exe。（如果您安装了适用于 Linux 的 Windows 子系统，则会拥有该文件。）Bazel 不支持此版本的 bash.exe。
- PATH：添加 Python 目录。
- JAVA_HOME：设置为 JDK 目录。
示例（使用 BAZEL_VS）：
```
export BAZEL_VS="C:/Program Files (x86)/Microsoft Visual Studio/2017/BuildTools"
export BAZEL_SH="$(cygpath -m $(realpath $(which bash)))"
export PATH="/c/python27:$PATH"
export JAVA_HOME="C:/Program Files/Java/jdk-21"
```
或（使用 BAZEL_VC）：
```
export BAZEL_VC="C:/Program Files (x86)/Microsoft Visual Studio/2017/BuildTools/VC"
export BAZEL_SH="$(cygpath -m $(realpath $(which bash)))"
export PATH="/c/python27:$PATH"
export JAVA_HOME="C:/Program Files/Java/jdk-21"
```
cd 到您解压缩发行版归档文件的目录。
运行编译脚本：env EXTRA_BAZEL_ARGS="--tool_java_runtime_version=local_jdk" ./compile.sh

将编译的输出置于 output/bazel.exe 中。这是一个独立的 Bazel 二进制文件，没有嵌入式 JDK。您可以将其复制到任何位置或就地使用。为方便起见，请将此二进制文件复制到 PATH 中的目录。

若要以可重现的方式构建 bazel.exe 二进制文件，还应在“运行编译脚本”步骤中设置 SOURCE_DATE_EPOCH。

您无需从 MSYS2 shell 运行 Bazel。您可以通过命令提示符 (cmd.exe) 或 PowerShell 运行 Bazel。