根本原因是当前工作目录不在Bazel workspace根目录；需先用find定位WORKSPACE文件并cd进入，再执行bazel build //...，否则BUILD文件无法被正确加载。
bazel build 命令报错找不到 BUILD 文件
根本原因不是项目没写 BUILD，而是当前工作目录不在 workspace 根目录。Bazel 要求 workspace 必须包含一个 WORKSPACE 或 WORKSPACE.bazel 文件，且所有 BUILD 文件都必须在该根目录的子路径下。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 先运行
find . -name "WORKSPACE" -o -name "WORKSPACE.bazel"确认 workspace 根在哪 - cd 进去再执行
bazel build //...，别在 src/ 或 cpp/ 子目录里直接 run - 如果项目原本是 CMake 的，
BUILD文件得手写——Bazel 不会自动转换，也别指望bazel build //:all能猜出你有啥源码 - 常见错误现象：
ERROR: error loading package '': Every .bzl file must have a corresponding package，基本就是路径错了
cc_binary 编译失败：undefined reference 到 std::string 或 std::cout
不是代码写错了，而是链接时没带标准库，或者用了不匹配的 STL 实现。Bazel 默认用 libc++（尤其在 macOS 上），但你的源码可能隐式依赖 libstdc++ 的符号。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 检查
cc_binary的linkopts和copts，别手动加-lstdc++——这会破坏 Bazel 对 toolchain 的控制 - 优先改
.bazelrc指定 STL：build --cxxopt=-stdlib=libc++ --linkopt=-stdlib=libc++（macOS 推荐）或--cxxopt=-stdlib=libstdc++（Linux 多数情况） - 更稳妥的做法是统一 toolchain：用
cc_toolchain_config.bzl显式声明，避免靠环境变量或默认猜测 - 性能影响：libc++ 通常比 libstdc++ 启动略快，但 ABI 不兼容，混用必炸
如何让 bazel 正确找到 system 头文件（比如 #include <jsoncpp></jsoncpp>）
Bazel 默认不搜索 /usr/include 或 /usr/local/include，它只认你显式声明的 includes 或 hdrs。直接 #include 系统级第三方头，99% 会报 'xxx' file not found。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 别用
copts = ["-I/usr/include/jsoncpp"]—— 这会让构建失去可重现性，且跨机器失效 - 正确做法是把 jsoncpp 声明为
cc_library依赖：cc_library( name = "jsoncpp", hdrs = glob(["include/json/*.h"]), includes = ["include"], visibility = ["//visibility:public"], ) - 如果用系统包管理器装的（apt/yum/brew），推荐用
new_local_repository或http_archive下载预编译头+lib，再 wrap 成cc_import+cc_library - 容易踩的坑：用
glob(["/usr/include/jsoncpp/**"])——glob不支持绝对路径，且违反 sandbox 隔离原则
修改了 .h 文件但 bazel build 不重新编译对应 .cc
这不是缓存问题，是 Bazel 的依赖分析没捕获到头文件依赖。它只靠 #include 路径做静态分析，如果用了宏、条件编译、或间接 include（A.h → B.h → C.h），就可能漏掉。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 确认
.h文件已列在对应cc_library的hdrs属性里；光写在srcs里没用 - 检查是否用了非标准 include 方式，比如
#include STRINGIFY(MY_HEADER)—— Bazel 解析不了宏展开，必须改成字面量路径 - 临时验证：加
--disk_cache="" --sandbox_debug运行，看实际执行的 g++ 命令里有没有那个头文件路径 - 最省事但代价高：加
tags = ["no-cache"]强制重编，仅用于调试，别提交
头文件依赖链越深，Bazel 分析越容易断点。宁可多写几行 hdrs，也别赌它能自动推出来。
