Bazel构建C++项目核心是编写WORKSPACE和BUILD文件,通过声明式设计实现可复现、可缓存的高效构建;WORKSPACE定义项目名与外部依赖,BUILD用cc_library/cc_binary/cc_test组织目标,配合bazel build/run/test等命令完成全流程。

用 Bazel 构建 C++ 项目,核心是写好 WORKSPACE 和 BUILD 文件,让 Bazel 理解你的依赖和编译规则。它不是“配置越复杂越强”,而是靠声明式、可复现、可缓存的设计提升大型项目的构建效率。
初始化 WORKSPACE:声明项目身份和外部依赖
每个 Bazel 项目根目录必须有 WORKSPACE 文件(可为空,但建议显式声明)。它定义项目名、加载外部依赖(如 googletest、abseil)和启用 C++ 规则。
- 用
workspace(name = "my_project")命名项目,这个名字会在引用内部目标时用到(如//:main) - 若需 Google 开源库,用
http_archive引入,例如接入absl:load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive") http_archive( name = "com_google_absl", urls = ["https://github.com/abseil/abseil-cpp/archive/refs/tags/20240116.0.tar.gz"], strip_prefix = "abseil-cpp-20240116.0", ) - 确保已启用 C++ 工具链:Bazel 6.0+ 默认启用;老版本需在
WORKSPACE中加load("@rules_cc//cc:defs.bzl", "cc_library")
编写 BUILD 文件:用目标(target)组织代码
BUILD 文件放在每个模块目录下,声明该目录能构建什么。C++ 最常用的是 cc_binary、cc_library 和 cc_test。
-
cc_library封装头文件和实现,供其他目标链接:cc_library( name = "utils", srcs = ["utils.cc"], hdrs = ["utils.h"], visibility = ["//visibility:public"], ) -
cc_binary构建可执行文件,通过deps显式声明依赖:cc_binary( name = "app", srcs = ["main.cc"], deps = [":utils", "@com_google_absl//absl/strings:strings"], ) -
cc_test写单元测试,自动集成gtest(如果已引入):cc_test( name = "utils_test", srcs = ["utils_test.cc"], deps = [":utils", "@com_google_googletest//:gtest_main"], )
常用命令:从构建到测试一步到位
Bazel 命令统一以 bazel 形式运行,支持通配符和标签语法(如 //... 表示所有子包)。
8CMS网站管理系统 (著作权登记号 2009SRBJ3516 ),基于微软 asp + Access 开发,是实用的双模建站系统,应用于企业宣传型网站创建、贸易型网站创建、在线购买商务型网站创建。是中小型企业能够以最低的成本、最少的人力投入、在最短的时间内架设一个功能齐全、性能优异、SEO架构合理的网站平台工具。8CMS的使命是把建设网站最大程度的简化。
立即学习“C++免费学习笔记(深入)”;
-
bazel build //:app—— 编译目标,输出在bazel-bin/下 -
bazel run //:app—— 构建并立即运行 -
bazel test //...—— 运行当前项目下所有测试 -
bazel query 'deps(//:app)'—— 查看依赖图,调试依赖问题很实用 -
bazel clean --expunge—— 彻底清空构建缓存(慎用,但解决诡异构建残留时有效)
小技巧:让 C++ 开发更顺手
Bazel 默认使用系统工具链,但你可以控制编译器行为、启用警告或自定义 C++ 标准。
- 在
.bazelrc中设置全局 C++ 选项:build --cxxopt=-std=c++17 build --copt=-Wall --copt=-Wextra build --linkopt=-static-libstdc++
- 用
cc_toolchain切换 GCC/Clang 或交叉编译(进阶场景,初学者可暂不深究) - 生成编译数据库(
compile_commands.json)供 VS Code 或 clangd 使用:bazel run @rules_cc//tools/cpp:run_compilation_database -- --output=compile_commands.json
基本上就这些。Bazel 的学习曲线不在语法多难,而在于转变思维——从“我怎么让编译器干活”变成“我如何精确描述模块关系”。写好 BUILD 文件,就是为工程立下契约。










