std::filesystem 路径处理本身跨平台一致，需用 path 构造和 / 拼接；exists() 失败多因权限或符号链接；遍历大目录须用 error_code 避免异常；编译需 C++17 支持及正确链接；跨文件系统操作非原子。
std::filesystem 在 Windows 和 Linux 上路径分隔符处理不一致？
不是 std::filesystem 本身不一致，而是你没用对接口。它内部会自动做平台适配，但前提是别手动拼接路径字符串。
- 错误做法：
"data/" + filename或"C:\temp\" + name—— 这样硬编码分隔符，跨平台必挂 - 正确做法：始终用
std::filesystem::path构造和拼接，比如std::filesystem::path("data") / filename，/运算符会自动转成（Windows）或/（Linux） - 注意
std::filesystem::path::generic_string()返回的是正斜杠风格（POSIX-like），适合日志或配置输出；而.string()返回本地风格（Windows 下含），适合传给系统 API
std::filesystem::exists() 返回 false，但文件明明存在？
大概率是权限、符号链接或路径解析问题，不是函数坏了。
- 检查是否在访问受限目录（如 Windows 的
Program Files或 Linux 的/root），std::filesystem::status()可能抛std::filesystem::filesystem_error，错误码常为permission_denied - 若路径含符号链接，
exists()默认不跟随（symlink_status()才查链接本身），要用exists(p, ec)并传入std::error_code捕获细节 - 路径中含
..或.时，建议先调用std::filesystem::canonical(p, ec)归一化，否则相对路径解析可能因当前工作目录不同而失效
遍历大目录时卡死或崩溃？
默认的 std::filesystem::recursive_directory_iterator 是同步且不跳过错误的，遇到坏链接、无权访问的子目录就会抛异常或阻塞。
- 务必用带
std::error_code&的构造函数：std::filesystem::recursive_directory_iterator(path, ec)，避免异常中断遍历 - 遍历时主动跳过不可访问项：
if (ec) { ec.clear(); continue; } - 性能敏感场景慎用
recursive_directory_iterator—— 它会为每个 entry 调用stat()系统调用。如果只需文件名，改用std::filesystem::directory_iterator配合手动递归更轻量 - Windows 上 NTFS 卷有重解析点（如挂载点），
options::skip_permission_denied不起作用，得自己判断is_symlink()或is_other()后跳过
std::filesystem 编译失败：identifier "filesystem" is undefined？
不是代码写错了，是编译器和标准库没对齐。
立即学习“C++免费学习笔记（深入）”；
- 确认编译器支持：GCC ≥ 8（需
-lstdc++fs链接）、Clang ≥ 9（macOS 自带 libc++ 需 ≥ 10）、MSVC ≥ 2017（15.7+） - CMake 中必须显式启用 C++17：
set(CMAKE_CXX_STANDARD 17)，且不能被子目录覆盖 - Linux 下 GCC 8/9 必须链接
stdc++fs库：target_link_libraries(myapp stdc++fs)，漏了就报未定义引用 - MinGW-w64 用户注意：部分旧版不完全支持
std::filesystem，建议切到 UCRT 版本或改用boost::filesystem
最易被忽略的一点：std::filesystem 的很多操作（尤其是 copy、rename）在跨文件系统时会退化为“读-写”而非原子操作，且不保证事务性。如果业务要求强一致性，得自己加锁或用外部工具（如 rsync）兜底。
