macOS 10.13下Clang14链接自带libc++配置问题咨询

编辑说明：本问题与《C++17下使用成员出现链接错误》问题完全无关！macOS 10.13平台的Clang14不提供-lstdc++fs选项。

环境前置说明：

• 当前系统固定为macOS 10.13 High Sierra，无法升级，该版本支持的最新Xcode内置Clang仅为Clang10
• 选择LLVM官方Clang14的原因是Apple自带Clang不支持address sanitizers

使用Clang14编译如下最小测试代码：

#include <iostream>
#include <filesystem>
namespace fs = std::filesystem;
int main()
{
    std::cout << "Current path is " << fs::current_path() << '\n';       
}

执行的编译命令为：

clang-14++ path.cpp -std=c++20

编译阶段抛出链接错误：

ld64.lld: error: undefined symbol: std::__1::__fs::filesystem::__current_path(std::__1::error_code*)
>>> referenced by /var/folders/_z/1q84ymcj36dgx7d2z7ybs6h40000gn/T/path-201e1b.o
clang-14: error: linker command failed with exit code 1 (use -v to see invocation)

排查后确认，默认参数下-lc++会优先链接系统内置Apple Clang携带的libc++，而非Clang14自带的对应库。手动在-lc++前添加-L/Users/alia/.local/clang_llvm_apple/lib指定Clang14的库目录后，程序可正常编译运行，但会弹出两个版本警告：

ld64.lld: warning: /Users/alia/.local/clang_llvm_apple/lib/libc++.dylib has version 11.6.0, which is newer than target minimum of 10.13.0
ld64.lld: warning: /Users/alia/.local/clang_llvm_apple/lib/libunwind.dylib has version 11.6.0, which is newer than target minimum of 10.13.0

现有两个疑问：

1. 是否有方法配置Clang默认链接自带的libc++，还是必须通过命令别名的方式，每次编译手动追加-L参数指定库路径？
2. 手动指定库路径链接Clang自带libc++的方式是否有负面影响，存在哪些需要注意的潜在隐患？

默认链接自带libc++的配置方法 #

不需要每次手动加参数或者写shell别名，有两种一劳永逸的方案：

• 如果你是自己编译Clang14，编译阶段直接指定DEFAULT_SYSROOT、LIBCXX_INSTALL_LIBRARY_DIR等编译选项，把自带libc++的搜索路径直接编译进Clang二进制，后续调用就会自动优先搜索自带库路径。如果用的是官方预编译的Clang14，用第二种方案更方便。
• 写Clang配置文件：在Clang14安装目录下找lib/clang/14/lib/x86_64-apple-darwin17/clang++.cfg（路径里的版本号、平台名按自己实际安装的版本调整），在文件里写一行-L/Users/alia/.local/clang_llvm_apple/lib，之后调用clang-14++时会自动加载这个配置里的参数，不需要手动追加路径。如果要对当前用户全局生效，也可以把配置写到~/.config/clang/clang++.cfg里。

额外提一句，手动指定路径的时候可以先加-nostdlib++参数，禁用默认的C标准库搜索逻辑，再显式链接-l:libc++.dylib，能完全避免误链到系统libc的问题，比单纯加-L参数更可靠。

手动指定库路径的注意事项 #

你看到的版本警告本质是Clang14自带的libc++默认的最低部署版本高于10.13，不是说程序一定跑不起来，但是有几个必须注意的坑：

• 不要混用不同版本的libc++。如果你的项目是多个二进制（可执行文件+动态库）组合，必须保证所有C代码都用同一个Clang14、链接同一份libc，绝对不能出现部分二进制链接系统libc++、部分链接Clang14自带libc++的情况，不然跨二进制传递std::string、容器这类对象的时候，因为内存布局、符号版本不一致，会直接崩溃，还很难排查。如果只是编译单个独立可执行文件，所有源码都用Clang14编译，基本不会出这类问题。
• 编译的时候一定要加-mmacosx-version-min=10.13参数，告诉编译器和libc你要兼容10.13系统，这个参数会让libc自动禁用依赖10.14及以上系统API的功能，绝大多数情况下那个版本警告对应的兼容性问题会被直接规避。只要你不用到libc++里强依赖高版本系统调用的组件，程序可以稳定运行。
• 分发程序的时候要么把Clang14自带的libc++.dylib、libunwind.dylib随程序打包，设置好rpath让程序优先加载同目录的库，要么编译的时候加-static-libc++ -static-libunwind把这两个库静态链接到可执行文件里。不要指望系统路径下有对应版本的库，不然程序拿到其他同版本10.13机器上跑的时候会报符号找不到的错误。注意静态链接只适合单可执行文件的场景，如果有多个动态库，静态链接libc++还是会出现跨二进制的符号冲突问题。

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