Bazel是适合大规模C++项目的高性能构建系统，支持跨平台、多语言和远程缓存。通过WORKSPACE和BUILD文件定义项目结构与依赖，实现快速增量构建和可重复输出，提升团队协作与CI/CD效率。
在现代C++开发中，尤其是面对大规模项目时，传统的构建方式如Makefile或CMake虽然灵活，但在跨平台、依赖管理和构建速度上逐渐显现出局限。Bazel 是由 Google 开发并开源的高性能构建系统，专为大型代码库设计，支持多语言（包括 C++）、可扩展性强，并具备极佳的增量构建和缓存能力。本文将带你快速入门 Bazel 在 C++ 项目中的使用，理解其核心概念与实践方法。
为什么选择 Bazel？
Bazel 的优势在于它对“可重复构建”和“确定性输出”的严格保证，这使得团队协作更高效，CI/CD 更稳定。对于 C++ 这类编译耗时长的语言，Bazel 能显著提升构建效率：
- 快速增量构建：只重新构建受更改影响的部分，利用精确的依赖分析。
- 分布式缓存与执行：支持远程缓存和远程执行，团队成员可共享编译结果。
- 统一多语言支持：除了 C++，还支持 Java、Python、Go 等，适合混合项目。
- 声明式构建规则：通过 BUILD 文件明确描述目标及其依赖，结构清晰。
Bazel 核心概念：WORKSPACE、BUILD 和 BUILD 规则
Bazel 构建基于两个关键文件：WORKSPACE 和 BUILD。
WORKSPACE 文件位于项目根目录，标识这是一个 Bazel 工作区。它可以定义外部依赖，比如引用第三方库：
立即学习“C++免费学习笔记（深入）”；
workspace(name = "my_cpp_project")
BUILD 文件则放在各个源码目录中，用于定义该目录下的构建目标（targets），例如可执行程序、库、测试等。
一个简单的 BUILD 文件示例：
cc_binary(
name = "hello",
srcs = ["hello.cc"],
)
这段代码定义了一个名为 hello 的 C++ 可执行文件，源码是 hello.cc。Bazel 会自动调用合适的编译器进行构建。
组织 C++ 项目结构与依赖管理
假设你的项目结构如下：
my_project/
├── WORKSPACE
├── main/
│ ├── main.cc
│ └── BUILD
└── lib/
├── hello.h
├── hello.cc
└── BUILD
在 lib/BUILD 中定义一个静态库：
cc_library(
name = "hello_lib",
srcs = ["hello.cc"],
hdrs = ["hello.h"],
visibility = ["//main:__pkg__"],
)
然后在 main/BUILD 中引用这个库：
cc_binary(
name = "app",
srcs = ["main.cc"],
deps = ["//lib:hello_lib"],
)
这里 //lib:hello_lib 是 Bazel 的标签（label）语法，表示路径为 lib 目录下名为 hello_lib 的目标。
visibility 控制谁可以依赖这个目标。上面设置为仅 main 包能访问，增强封装性。
处理外部依赖：引入第三方库
实际项目常需使用外部库，如 absl（Abseil）、gtest 等。Bazel 支持多种方式引入，最常用的是通过 http_archive 在 WORKSPACE 中声明。
例如，在 WORKSPACE 中引入 Google Test：
load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")
http_archive(
name = "com_google_googletest",
urls = ["https://github.com/google/googletest/archive/refs/tags/v1.14.0.zip"],
strip_prefix = "googletest-1.14.0",
)
然后在测试的 BUILD 文件中使用：
cc_test(
name = "hello_test",
srcs = ["hello_test.cc"],
deps = [
"//lib:hello_lib",
"@com_google_googletest//:gtest_main",
],
)
注意前缀 @com_google_googletest 表示这是一个外部仓库。
常用命令与构建流程
Bazel 提供简洁的命令行接口：
-
bazel build //main:app—— 编译目标 -
bazel run //main:app—— 构建并运行 -
bazel test //lib:hello_test—— 执行测试 -
bazel clean—— 清理构建产物
所有输出集中在 bazel-bin/、bazel-genfiles/ 等符号目录下，不污染源码树。
小贴士与最佳实践
- 保持 BUILD 文件细粒度，每个逻辑模块对应一个目标。
- 优先使用
cc_library封装功能，避免重复编译。 - 合理设置
visibility，防止依赖混乱。 - 启用远程缓存（Remote Cache）可极大加速团队构建速度。
- 结合
.bazelrc配置常用选项，如编译器标志、并发数等。
基本上就这些。Bazel 初学门槛略高，但一旦掌握，它带来的构建可靠性和效率提升是值得的，尤其适合中大型 C++ 项目。从一个小例子开始尝试，逐步迁移现有项目，你会感受到它的强大之处。
