如何在macOS中使用libc++调试版本？解决链接未定义符号问题

首先，你猜的完全没错——macOS系统默认提供的libc确实只有发行（release）版本，没有预编译的调试（debug）版本。要使用带调试功能的libc，你需要自己从LLVM源码编译调试版的libc和libcabi库。下面是具体步骤：

1. 获取LLVM源码 #

首先克隆包含libc和libcabi的LLVM项目仓库：

git clone --depth=1 --branch llvmorg-17.0.6 https://github.com/llvm/llvm-project.git
cd llvm-project

（注：可以替换llvmorg-17.0.6为你需要的LLVM版本，建议选择和你当前Xcode/clang版本匹配的版本，避免兼容性问题）

2. 编译调试版的libc和libcabi #

创建单独的编译目录，然后用CMake配置调试模式的编译选项：

mkdir build-debug && cd build-debug
cmake -G Ninja \
  -DCMAKE_BUILD_TYPE=Debug \
  -DLLVM_ENABLE_PROJECTS="libcxx;libcxxabi" \
  -DCMAKE_INSTALL_PREFIX=/usr/local/libcxx-debug \
  ../llvm

执行编译并安装调试版库：

ninja install-cxx install-cxxabi

这会把调试版的libc++库安装到/usr/local/libcxx-debug目录下。

3. 在你的项目中使用调试版libc++ #

编译项目时，需要指定使用我们自己编译的调试版libc++，同时保留_LIBCPP_DEBUG=1的定义：

clang++ -std=c++17 \
  -D_LIBCPP_DEBUG=1 \
  -I/usr/local/libcxx-debug/include/c++/v1 \
  -L/usr/local/libcxx-debug/lib \
  -Wl,-rpath,/usr/local/libcxx-debug/lib \
  your_source.cpp -o your_program

这里的核心配置点：

• -I指定调试版libc++的头文件路径
• -L指定调试版库文件的路径
• -Wl,-rpath确保程序运行时能找到调试版库

关于你遇到的未定义符号错误 #

你看到的std::__1::__libcpp_db::__decrementable(void const*) const这个符号，是libc调试模式下特有的函数——发行版libc中完全没有这个符号。所以当你开启_LIBCPP_DEBUG=1却链接系统默认的发行版libc时，必然会出现这种未定义符号的错误。按照上面的步骤使用自己编译的调试版libc后，这个问题就会自动解决，因为调试版库中包含了所有调试相关的符号实现。

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