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 <verb> <target> 形式运行，支持通配符和标签语法（如 //...<code> 表示所有子包）。
立即学习“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 文件，就是为工程立下契约。
