Ubuntu 20.04下如何让Clang静态链接libc++消除运行时依赖？

正确编译命令（基于本地构建的静态libc++） #

如果已将静态libc++/libc++abi安装到/usr/local/libcxx，使用以下命令编译：

clang++ test.cpp -std=c++20 \
  -I/usr/local/libcxx/include/c++/v1 \
  -L/usr/local/libcxx/lib \
  -stdlib=libc++ \
  -static \
  -lc++abi \
  -lm -lpthread -ldl

关键参数说明 #

• -stdlib=libc++：强制Clang使用libc标准库，替代默认的libstdc，不可与-static-libstdc++混用（这是之前出现大量链接错误的核心原因）。
• -static：告诉链接器静态链接所有依赖库，包括libc++、libc++abi及系统基础库，避免动态依赖。
• -lc++abi：显式链接libcabi（libc的异常处理、RTTI依赖该库），确保静态版本被选中（需保证-L指定的路径下存在libc++abi.a）。
• -lm -lpthread -ldl：补充链接系统必要的静态库，解决math、线程、动态链接相关的符号缺失问题。
• -I/-L：指定本地构建的libc++头文件和库文件路径，确保Clang优先使用你编译的静态版本，而非系统默认库。

解决重复符号__lll_lock_wait_private问题 #

该错误源于链接顺序或符号冲突，可通过以下方式修复：

1. 调整链接顺序：将系统库参数（-lm -lpthread -ldl）放在命令末尾，让链接器优先处理libc++的符号，再匹配系统库符号。
2. 添加链接器参数：如果仍有冲突，可添加-Wl,--exclude-libs,ALL避免导出不必要的静态库符号，或-Wl,--allow-multiple-definition（仅在确认符号无实际冲突时使用）。

验证静态链接结果 #

编译完成后，用以下命令检查是否无动态依赖：

ldd ./a.out

正常输出应为：not a dynamic executable，或仅显示系统最基础的静态链接依赖（无libc++.so、libc++abi.so）。

本地构建静态libc++的注意事项 #

确保编译libc++时启用静态库选项，示例CMake构建命令：

cmake -G Ninja -S llvm-project/libcxx -B build-libcxx \
  -DCMAKE_BUILD_TYPE=Release \
  -DCMAKE_INSTALL_PREFIX=/usr/local/libcxx \
  -DLIBCXX_ENABLE_STATIC=ON \
  -DLIBCXX_ENABLE_SHARED=OFF \
  -DLIBCXX_CXX_ABI=libcxxabi \
  -DLIBCXX_CXX_ABI_INCLUDE_PATHS=llvm-project/libcxxabi/include \
  -DLIBCXX_CXX_ABI_LIBRARY_PATH=llvm-project/libcxxabi/build/lib

同步编译并安装libc++abi，确保静态库文件生成在指定路径下。

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