Bazel项目源码编译指南：从零构建构建工具

前言

Bazel作为Google开源的构建工具，以其高效的增量构建和跨语言支持特性广受开发者欢迎。本文将详细介绍如何从源码编译Bazel，包括两种主要方式：使用现有Bazel二进制进行编译（推荐）和完全从零开始的引导编译（Bootstrapping）。

方法一：使用现有Bazel二进制编译

准备工作

1. 获取Bazel二进制：

   • 确保已安装最新版Bazel，可通过包管理器或直接下载预编译二进制
   • 验证安装：终端输入bazel --version应能正确显示版本号

2. 获取源码：

   • 下载Bazel源码压缩包并解压，或直接克隆源码仓库
   • 建议创建专用目录存放源码，如~/bazel-src

3. 安装依赖：

   • JDK 21（必须）
   • C++编译工具链（gcc/clang等）
   • Python（2.x或3.x均可）
   • zip/unzip工具

编译步骤（Unix-like系统）

cd ~/bazel-src
bazel build //src:bazel-dev

编译完成后，可在bazel-bin/src/目录下找到bazel-dev二进制文件。

编译步骤（Windows系统）

1. 打开命令提示符
2. 执行：

cd %USERPROFILE%\bazel-src
bazel build //src:bazel-dev.exe

生成的二进制位于bazel-bin\src\bazel-dev.exe

高级选项

• 优化编译（生成更小但编译更慢的二进制）：

  bazel build //src:bazel --compilation_mode=opt
  

• 嵌入版本信息：

  bazel build //src:bazel-dev --stamp --embed_label=X.Y.Z
  

方法二：从零引导编译（Bootstrapping）

当没有现成Bazel二进制可用时，可采用此方法。

准备工作

1. 获取分发版源码：

   • 必须下载bazel-<version>-dist.zip格式的分发包
   • 注意这不是常规的GitHub源码树，包含额外生成文件

2. 系统依赖：

   • Unix-like系统：Bash、JDK 21、C++工具链、Python
   • Windows系统：MSYS2、Visual C++编译器、JDK 21、原生Python

Unix-like系统引导步骤

cd /path/to/extracted/source
env EXTRA_BAZEL_ARGS="--tool_java_runtime_version=local_jdk" bash ./compile.sh

生成的二进制位于output/bazel

Windows系统引导步骤

1. 配置环境变量：

   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"
   

2. 执行编译：

   env EXTRA_BAZEL_ARGS="--tool_java_runtime_version=local_jdk" ./compile.sh
   

生成的二进制位于output/bazel.exe

常见问题排查

1. 权限问题：

   • Unix系统需确保二进制有执行权限：chmod +x bazel

2. 路径问题：

   • 确保编译工具链在PATH中
   • Windows特别注意不要使用WSL的bash

3. 版本冲突：

   • 严格使用JDK 21，其他版本可能导致问题

4. Windows特殊要求：

   • 必须使用原生Python而非MSYS2提供的版本
   • Visual Studio版本需2015或更新

结语

通过本文介绍的两种方法，开发者可以根据自身环境选择最适合的Bazel编译方式。对于大多数用户，推荐使用现有Bazel二进制进行编译，这种方法更简单可靠。只有在特殊环境下才需要从零引导编译。编译完成后得到的Bazel二进制可直接使用，无需额外安装步骤。

建议将编译好的二进制放入系统PATH路径以便全局访问，持续关注Bazel的版本更新以获得最新功能和性能优化。