在macOS10.13/10.14用MacPorts LLVM15编译std::filesystem出错求助

问题场景 #

在macOS 10.13或10.14系统上，使用MacPorts安装的LLVM/clang 15.0.5编译以下C++17代码：

#include <filesystem>
#include <stdio.h>

int main() {
  std::filesystem::path file("/file.txt");
  printf("exists: %d\n", std::filesystem::exists(file));
  return 0;
}

遇到以下三类问题：

1. macOS 10.13编译时链接错误 #

执行编译命令：

$ /opt/local/bin/clang++-mp-15 -std=c++17 test.cpp -o test

出现错误：

Undefined symbols for architecture x86_64:
  "std::__1::__fs::filesystem::__status(std::__1::__fs::filesystem::path const&, std::__1::error_code*)", referenced from:
      __ZNSt3__14__fs10filesystem6existsB6v15005ERKNS1_4pathE in test-5b7d68.o
ld: symbol(s) not found for architecture x86_64
clang: error: linker command failed with exit code 1 (use -v to see invocation)

2. macOS 10.14编译成功但运行失败 #

编译无报错，但运行二进制时崩溃：

$ ./test

错误输出：

dyld: lazy symbol binding failed: Symbol not found: __ZNSt3__14__fs10filesystem8__statusERKNS1_4pathEPNS_10error_codeE
  Referenced from: /path/to/./test
  Expected in: /usr/lib/libc++.1.dylib

dyld: Symbol not found: __ZNSt3__14__fs10filesystem8__statusERKNS1_4pathEPNS_10error_codeE
  Referenced from: /path/to/./test
  Expected in: /usr/lib/libc++.1.dylib

Abort trap: 6

3. 尝试--sysroot参数后的错误 #

指定sysroot路径时出现库找不到：

$ /opt/local/bin/clang++-mp-15 --sysroot /opt/local/libexec/llvm-15 -std=c++17 test.cpp -o test

错误：

ld: library not found for -lc++
clang: error: linker command failed with exit code 1 (use -v to see invocation)

核心原因 #

macOS 10.15及以上才原生支持std::filesystem，10.13/10.14的系统libc++.dylib没有实现该模块。MacPorts安装的LLVM 15自带完整的libc++（包含std::filesystem），但默认编译配置仍会调用系统libc++，导致链接或运行时找不到对应符号。

解决方案 #

使用以下编译命令，强制链接MacPorts LLVM自带的libc++并指定运行时库路径：

/opt/local/bin/clang++-mp-15 -std=c++17 -stdlib=libc++ -Wl,-rpath,$(/opt/local/bin/llvm-config-mp-15 --libdir) test.cpp -o test

参数说明 #

• -stdlib=libc++：明确指定使用LLVM提供的libc++标准库，而非系统默认版本，确保能找到std::filesystem的符号实现。
• -Wl,-rpath,$(/opt/local/bin/llvm-config-mp-15 --libdir)：通过llvm-config-mp-15自动获取LLVM库路径，告诉链接器添加运行时搜索路径，让程序执行时能加载MacPorts LLVM的libc++.dylib，而非系统目录下的旧版本。

验证 #

编译完成后直接运行：

$ ./test

此时会正常调用LLVM自带的std::filesystem实现，输出文件存在状态。

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