std::filesystem 在 C++17 中基本跨平台，但需编译器/标准库完整支持并规避路径分隔符硬编码、UTF-8 处理不当、异常未捕获、符号链接循环等陷阱。
std::filesystem 在 C++17 中是否真能跨平台？
不能直接跨平台，但比手写 stat/FindFirstFile 或依赖 Boost 更可靠——前提是编译器和标准库都完整支持 std::filesystem，且你避开 Windows 路径分隔符硬编码这类低级错误。
MSVC 从 2017 15.9 开始支持（需开启 /std:c++17），GCC 从 9.1 起默认启用（GCC 8 需链接 -lstdc++fs），Clang 10+ 依赖 libc++ 或 libstdc++ 的实现质量。macOS 上 libc++ 对 std::filesystem 的符号链接处理曾有 bug，直到 macOS 12+ 才稳定。
路径拼接为什么用 operator/ 而不是字符串拼接？
因为 std::filesystem::path 会自动适配平台分隔符："a" / "b" / "c" 在 Windows 得到 a\b\c，在 Linux/macOS 得到 a/b/c；而手动拼 "a" + "/" + "b" 在 Windows 下可能生成非法路径，或被某些 API 拒绝（比如 CreateFileW 对正斜杠容忍但不推荐）。
常见错误现象：
立即学习“C++免费学习笔记（深入）”；
- 用
path.string() + "/sub"导致 Windows 下出现混合分隔符（C:\foo/\bar），部分函数返回std::filesystem::filesystem_error - 把用户输入的原始字符串直接构造
path，没调用std::filesystem::u8path处理 UTF-8 字节流（Linux/macOS 常见，Windows 控制台默认 ANSI）
正确做法：
- 始终用
operator/拼接路径组件：auto p = std::filesystem::path{"src"} / "main.cpp"; - 读取命令行参数或配置文件中的 UTF-8 路径时，用
std::filesystem::u8path(argv[1])构造path - 避免对
path调用.c_str()后传给 C API；优先用.native()或.u8string()
判断文件是否存在却抛出 filesystem_error 怎么办？
因为 std::filesystem::exists() 在遇到权限不足、挂载点失效、符号链接断裂等情况时，会抛异常，而不是返回 false。这和很多人直觉相反——它不是“查存在”，而是“查可访问的存在”。
使用场景：
- 检查配置文件是否存在并可读：应捕获异常，或改用
std::filesystem::status()+std::filesystem::exists(status)组合 - 遍历目录时跳过无权访问的子目录：必须用
std::filesystem::is_directory()前加 try/catch，否则整个遍历中断
推荐写法：
std::error_code ec;
if (!std::filesystem::exists(p, ec)) {
if (ec) {
// 权限拒绝、路径不存在、设备不可用等，按需处理
return false;
}
return false; // 真不存在
}
return true;
注意：std::error_code 版本不抛异常，但你要自己检查 ec.value() != 0；漏掉这个判断就等于忽略所有系统错误。
递归遍历目录时性能卡顿或崩溃的原因
默认的 std::filesystem::recursive_directory_iterator 会严格遵循符号链接（除非显式传 std::filesystem::directory_options::skip_permission_denied），在含循环软链或 NFS 挂载点的环境里，可能无限递归或阻塞数秒。
性能影响：
- 每次迭代都触发一次
stat()系统调用，大量小文件下 I/O 成瓶颈 - 未设置深度限制时，深层嵌套目录（>100 层）可能耗尽栈空间（尤其 MSVC 默认栈小）
- Linux 上若目录含数万项，
readdir()返回慢，iterator 构造延迟明显
实操建议：
- 构造时传入
std::filesystem::directory_options::skip_permission_denied避免因权限中断 - 用
disable_symlinks_following()关闭软链跟随，再手动判断is_symlink() - 需要限深时，不要依赖 iterator 内置 depth（它只反映当前层级），改用显式计数 +
pop() - 对海量文件，考虑先用
std::filesystem::directory_iterator做一层过滤，再对子目录递归
跨平台最麻烦的从来不是 API 差异，而是不同系统对“路径合法”“权限语义”“符号链接行为”的定义根本不一致——std::filesystem 只封装了共性，边界情况还得你盯着 errno、GetLastError 和实际行为。
