std::filesystem 在 libc++ 中需显式链接 -lc++fs 库，因其被剥离为独立组件，且必须置于 -lc++ 和 -lc++abi 之后；CMake 中须手动添加 c++fs 并注意顺序与平台依赖。
直接说结论：std::filesystem 在 libc++ 中不是开箱即用的，即使你用了 -stdlib=libc++，链接时仍大概率报 undefined reference to `std::filesystem::path::path` 这类错误——根本原因是 libc++ 默认不把 std::filesystem 实现编译进主库，它被拆成独立的 libc++fs 库，必须显式链接。
为什么 libc++ 不像 libstdc++ 那样自动带 filesystem
libc++ 的设计哲学是“按需链接”，所有非核心组件（如 std::filesystem、std::experimental::coroutine）都剥离为单独的静态/动态库。而 GCC 的 libstdc++ 从 9.1 起默认把 std::filesystem 打包进主库，只需加 -lstdc++fs 就能补全（GCC 8.4 则必须加）；但 libc++ 没这个“默认兜底”逻辑。
常见错误现象：
- 编译通过，但链接时报一堆
undefined reference to std::filesystem::xxx - 用
clang++ -stdlib=libc++ main.cpp直接失败，加了-lc++也无效 - 误以为是 C++17 标准没开，反复加
-std=c++17，其实问题不在这里
必须加 -lc++fs，且顺序不能错
libc++fs 是 libc++ 的配套文件系统实现库，名字固定为 libc++fs，对应链接选项就是 -lc++fs。它依赖 libc++ 和 libc++abi，所以链接顺序必须是：
立即学习“C++免费学习笔记（深入）”；
-
-lc++fs放在-lc++和-lc++abi之后 - 如果用
-static-libc++，也要配-static-libc++fs（需 libc++ 15+） - 在 CMake 中，不能只写
target_link_libraries(myapp PRIVATE c++)，必须显式加c++fs
命令行示例：
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
clang++ -std=c++17 -stdlib=libc++ main.cpp -lc++fs -lc++ -lc++abi -o app
注意：-lc++fs 必须在 -lc++ 之后，否则链接器找不到它所依赖的 libc++ 符号。
CMake 中正确链接 libc++fs 的写法
CMake 不会自动推导 libc++fs，哪怕你设了 set(CMAKE_CXX_STANDARD 17) 和 set(CMAKE_CXX_STANDARD_REQUIRED ON)。必须手动指定库名，并确保它出现在 target_link_libraries 的靠后位置：
- 先确认编译器实际用了 libc++：
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -stdlib=libc++") - 链接时显式加上
c++fs：target_link_libraries(myapp PRIVATE c++ c++abi c++fs) - 如果目标平台是 macOS，还需加
-framework CoreFoundation（std::filesystem内部调用 CF API） - Linux 下 libc++fs 依赖
librt和libpthread，建议一并加上：rt pthread
漏掉 c++fs 或顺序颠倒，CMake 生成的 Makefile 里就看不到这个库，链接必然失败。
libc++fs 的 ABI 兼容性与运行时依赖
libc++fs 不是纯头文件库，它包含实际的符号实现，因此：
- 静态链接时（
-static-libc++），必须有对应版本的libc++fs.a，否则报cannot find -lc++fs - 动态链接时，运行时需确保
libc++fs.so在LD_LIBRARY_PATH或系统路径中，否则./app启动就报error while loading shared libraries: libc++fs.so.1: cannot open shared object file - 不同 libc++ 版本间
libc++fsABI 不保证兼容，升级 libc++ 后必须重编译，不能混用.so文件
最容易被忽略的一点：libc++fs 在较老版本（如 LLVM 12 之前）可能未完全实现 C++17 filesystem 规范，比如缺少 std::filesystem::copy_file 的某些重载。遇到奇怪的编译错误（不是链接错误），先查你用的 libc++ 版本是否完整支持所需接口。
