libc++.so.1 是 LLVM libc++ 标准库的动态链接文件（soname），用于 Linux/macOS 上 Clang 编译的程序；启动时报找不到，说明运行时加载器未在搜索路径中发现该文件，需通过 rpath、LD_LIBRARY_PATH 或 ldconfig 配置路径，并确保 libc++abi.so.1 同时存在。
libc++.so.1 是什么，为什么启动时找不到
libc++.so.1 是 LLVM libc++ 标准库的动态链接版本（soname），不是 Android 的 libc++_shared.so，也不是 GNU 的 libstdc++.so。它常见于 Linux/macOS 上用 Clang + libc++ 编译的程序。启动时报 “error while loading shared libraries: libc++.so.1: cannot open shared object file”，说明运行时加载器（ld-linux.so 或 dyld）在所有搜索路径里都没找到这个文件——和编译是否成功完全无关。
检查程序真正依赖哪个 soname
别凭感觉猜，先确认你的可执行文件到底要找什么：
- 运行
ldd ./your_program | grep c++，看输出是不是libc++.so.1 => not found - 更准确的方式是查动态段：
readelf -d ./your_program | grep NEEDED | grep c++，确认实际记录的依赖名 - 注意：如果输出是
libc++.so（无版本号），那可能是构建时没带-Wl,-soname=libc++.so.1，或链接了错误的 libc++ 安装路径
Linux 下让 libc++.so.1 被找到的三种可靠方式
Linux 动态加载器按固定顺序找库，优先级从高到低：
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 程序内嵌的
DT_RUNPATH（推荐）：编译时加-Wl,-rpath,$ORIGIN/../lib或-Wl,-rpath,/usr/local/lib，这样路径写死在二进制里，不依赖环境变量 -
LD_LIBRARY_PATH（仅调试）：临时生效，LD_LIBRARY_PATH=/usr/local/lib ./your_program，CI/生产环境禁用 - 系统缓存（长期方案）：把 libc++.so.1 所在目录加入
/etc/ld.so.conf.d/libc++.conf，再运行sudo ldconfig；注意该路径下必须有真实文件libc++.so.1，且最好有指向它的软链接libc++.so → libc++.so.1
常见踩坑点：Clang 安装不完整 or 路径错位
很多用户用包管理器（如 apt、brew）装 Clang，但只装了编译器，没装 runtime 库：
立即学习“C++免费学习笔记（深入）”；
- Debian/Ubuntu：需额外安装
libc++1和libc++abi1包（不是libc++-dev） - macOS Homebrew：
brew install llvm后，libc++.dylib 在$(brew --prefix llvm)/lib，但默认不加入系统搜索路径 - 手动编译 LLVM：务必启用
-DLLVM_ENABLE_RTTI=ON -DLIBCXXABI_ENABLE_SHARED=YES，否则不会生成libc++.so.1 - 混淆
libc++.so（符号链接）和libc++.so.1（真实文件）：ls -l /usr/lib/x86_64-linux-gnu/libc++.so*看是否缺失软链接
最易被忽略的是：libc++.so.1 通常和 libc++abi.so.1 成对出现，缺一不可；单独拷贝 libc++.so.1 到目标机器，大概率会立刻报 libc++abi.so.1 not found。
