Bazel构建C++项目的核心是规范组织代码和编写BUILD文件。需创建WORKSPACE文件，按包（含BUILD文件的目录）划分代码；用cc_library、cc_binary等规则声明目标，显式列出源文件与头文件；通过bazel build/run/test命令构建运行，支持增量编译与缓存；外部依赖用http_archive在WORKSPACE中声明，BUILD中以@name引用。
Bazel 是 Google 开源的高性能构建工具，专为大型、多语言项目设计，C++ 是其原生支持最成熟的语言之一。用好 Bazel 写 C++，核心不是“怎么装”，而是“怎么组织代码 + 怎么写 BUILD 文件”。下面直奔实用要点。
初始化项目结构：按 Bazel 规范组织 C++ 代码
Bazel 强制要求工作区（workspace）有明确根目录和声明文件。新建一个空目录，放入 WORKSPACE 文件（可为空，但必须存在），再按功能或模块划分包（package），每个包是含 BUILD 或 BUILD.bazel 的子目录。
例如典型结构：
my_project/
├── WORKSPACE
├── main/
│ ├── main.cc
│ └── BUILD
└── lib/
├── math_utils.cc
├── math_utils.h
└── BUILD
注意：Bazel 中“包” = 包含 BUILD 文件的目录及其所有子目录（除非被子 BUILD 文件截断）；头文件和源文件需显式声明在目标中，不能靠路径自动发现。
立即学习“C++免费学习笔记（深入）”；
写 BUILD 文件：用 cc_library 和 cc_binary 定义 C++ 构建单元
每个 BUILD 文件定义一组构建目标（target）。C++ 常用规则：
-
cc_library：编译成静态库（.a）或接口，供其他目标依赖 —— 所有头文件必须列在hdrs或srcs中 -
cc_binary：生成可执行文件，必须指定srcs（含 main 函数）并可deps到其他 cc_library -
cc_test：类似 cc_binary，但专用于测试，可自动集成 gtest
示例（main/BUILD）：
cc_binary(
name = "app",
srcs = ["main.cc"],
deps = ["//lib:math_utils"],
)
对应 lib/BUILD：
cc_library(
name = "math_utils",
srcs = ["math_utils.cc"],
hdrs = ["math_utils.h"],
visibility = ["//main:__pkg__"], # 控制谁能依赖它
)
关键细节：路径以 // 开头表示从 workspace 根开始；visibility 默认私有，跨包引用必须显式放开。
构建与运行：命令简洁，缓存高效
终端进入 workspace 根目录后：
-
bazel build //main:app—— 编译目标，输出在bazel-bin/main/app -
bazel run //main:app—— 构建并立即执行 -
bazel test //lib:math_utils_test—— 运行测试（需先定义 cc_test 目标） -
bazel clean --expunge—— 彻底清空输出和缓存（调试时有用）
Bazel 自动追踪文件依赖、增量编译、远程缓存复用 —— 改一个 .h，只重编依赖它的 targets，不碰无关模块。
引入外部依赖：用 http_archive + bind 或 rules_cc
不推荐手动下载第三方库。标准做法是在 WORKSPACE 中声明：
load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")
http_archive(
name = "com_google_absl",
urls = ["https://www.php.cn/link/028d0a7edbc0a88a9c0bfa5822d7b376"],
strip_prefix = "abseil-cpp-20230125.3",
)
然后在 BUILD 中引用
deps = ["@com_google_absl//absl/strings"]
常用库如 gtest、protobuf、fmt 都有官方或社区维护的规则。C++ 新项目建议直接用 rules_cc（Bazel 官方 C++ 规则集），它提供更稳定的 ABI 控制和 toolchain 配置能力。
