Mac下如何让Bazel+Clang输出更具描述性的编译/链接错误

问题根源 #

Mac系统的dyld默认启用延迟绑定（Lazy Binding），Bazel默认遵循这一行为。这意味着链接器不会在构建阶段检查所有未定义符号，而是推迟到程序运行时才解析。因此运行时触发符号缺失错误时，dyld仅输出missing symbol called，缺少具体符号名和引用位置的详细信息。而直接使用clang++编译时，默认会在链接阶段强制检查未定义符号，所以报错信息更完整。

解决方案 #

1. 针对单个目标启用链接阶段检查（推荐） #

在目标的BUILD规则中添加linkopts，仅对当前目标启用链接时未定义符号检查，不会影响依赖库的构建：

cc_binary(
  name = "main",
  srcs = ["main.cc"],
  linkopts = ["-Wl,-undefined,error"],
)

执行bazel build :main时，会在链接阶段直接输出详细错误，与clang++ main.cc的报错一致：

Undefined symbols for architecture arm64:
  "hello()", referenced from:
      _main in main.cc.o
ld: symbol(s) not found for architecture arm64
clang: error: linker command failed with exit code 1 (use -v to see invocation)

2. 临时全局启用（仅调试用） #

如果需要临时对某个构建命令启用全局检查，不要修改.bazelrc，直接在命令行添加参数：

bazel build :main --linkopt="-Wl,-undefined,error"

这种方式仅对当前构建生效，不会破坏依赖库的正常构建流程。

3. 针对包内所有目标启用 #

如果需要给当前目录下的所有目标启用检查，可以在BUILD文件顶部添加包级默认配置：

package(default_linkopts = ["-Wl,-undefined,error"])

cc_binary(
  name = "main",
  srcs = ["main.cc"],
)

此配置仅作用于当前包内的规则，外部依赖不受影响。

注意事项 #

不要将-Wl,-undefined,error全局添加到.bazelrc中，部分依赖库（如absl）可能存在合法的延迟初始化符号或动态加载逻辑，全局启用会导致这些依赖构建失败。

内容的提问来源于stack exchange，提问作者Tim