使用Clang16.0.2编译TensorFlow2.14时无法链接标准C++库怎么办？

问题场景 #

在Docker+Ubuntu22.04环境下，使用官方仓库的Clang16.0.2编译仅CPU版本的TensorFlow2.14，此前成功编译过r2.12和r2.13版本。执行编译命令：

bazel clean --expunge && bazel build -c opt --cxxopt=-D_GLIBCXX_USE_CXX11_ABI=1 //tensorflow/tools/pip_package:build_pip_package

编译时出现标准库找不到的错误：

ERROR: /root/.cache/bazel/_bazel_root/f3e6cea3d5621cddee645150a95a9495/external/llvm-project/llvm/BUILD.bazel:191:11: Compiling llvm/lib/Demangle/Demangle.cpp [for tool] failed: (Exit 1): clang failed: error executing command (from target @llvm-project//llvm:Demangle) /usr/lib/llvm-16/bin/clang -U_FORTIFY_SOURCE -fstack-protector -Wall -Wthread-safety -Wself-assign -Wunused-but-set-parameter -Wno-free-nonheap-object -fcolor-diagnostics -fno-omit-frame-pointer -g0 ... (remaining 70 arguments skipped)
In file included from external/llvm-project/llvm/lib/Demangle/Demangle.cpp:13:
external/llvm-project/llvm/include/llvm/Demangle/Demangle.h:12:10: fatal error: 'cstddef' file not found
#include
^~~~~~~~~
1 error generated.
Target //tensorflow/tools/pip_package:build_pip_package failed to build
Use --verbose_failures to see the command lines of failed build steps.
INFO: Elapsed time: 0.324s, Critical Path: 0.12s
INFO: 39 processes: 36 internal, 3 local.
FAILED: Build did NOT complete successfully

解决方案 #

1. 安装完整的标准库开发依赖 #

Ubuntu22.04默认搭配gcc11，对应的libstdc++开发包可能未安装完整，执行以下命令补装：

apt update && apt install -y libstdc++-11-dev libc6-dev

2. 调整Bazel编译参数，强制指定Clang使用libstdc++ #

TensorFlow依赖libstdc++，而Clang在Ubuntu环境下可能默认尝试使用libc++，导致标准库路径不匹配。修改编译命令，添加显式指定编译器和标准库的参数：

bazel clean --expunge && bazel build -c opt \
  --cxxopt=-D_GLIBCXX_USE_CXX11_ABI=1 \
  --cc=/usr/lib/llvm-16/bin/clang \
  --cxx=/usr/lib/llvm-16/bin/clang++ \
  --cxxopt=-stdlib=libstdc++ \
  --host_cxxopt=-stdlib=libstdc++ \
  //tensorflow/tools/pip_package:build_pip_package

3. 验证Clang本身的标准库关联 #

先单独测试Clang能否正常编译包含标准库的简单程序，确认问题是否出在Bazel配置：
创建测试文件test.cpp：

#include <cstddef>
int main() { return 0; }

用Clang编译：

/usr/lib/llvm-16/bin/clang++ test.cpp -o test -stdlib=libstdc++

如果编译失败，说明Clang本身未正确关联标准库，可通过添加环境变量指定标准库路径：

export CPLUS_INCLUDE_PATH=/usr/include/c++/11:/usr/include/x86_64-linux-gnu/c++/11:$CPLUS_INCLUDE_PATH

再重新执行Bazel编译命令。

4. 兼容性 fallback：尝试调整Clang版本 #

如果上述方法无效，可能是TensorFlow2.14与Clang16存在兼容性问题，可尝试降级到Clang15或升级到Clang17，再重新编译。

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