C++中的std::filesystem是什么？（如何跨平台处理文件路径）

std::Filesystem 能跨平台但需谨慎使用：路径语法自动归一化，但 copy、hard_link_count、last_write_time 等操作存在系统差异；拼接应使用 / 运算符，中文路径须用 u8path，windows 长路径需显式启用支持。

std::filesystem 是 c++17 引入的跨平台路径操作标准库

它不是“封装了系统 API 的万能工具”，而是提供了一套统一语义的路径抽象和基础文件操作接口。能否真正跨平台，取决于你用不用对函数、怎么处理错误、以及是否绕开了底层差异点。

哪些操作能真正跨平台，哪些不能

std::filesystem 对路径语法（如 "a/b/c" 和 "abc"）自动归一化，std::filesystem::path 构造时会按当前平台转换分隔符；但以下操作仍需谨慎：

• std::filesystem::copy：在 Windows 上复制只读文件会失败，linux 不会；必须先 permissions(path, perms::owner_write)
• std::filesystem::hard_link_count：Windows NTFS 支持硬链接，但 FAT32 / exFAT 不支持，返回值可能为 1 即使实际无硬链接
• std::filesystem::last_write_time：Windows 时间精度是 100ns，Linux 默认是 1s（ext4）或 1ns（xfs），比较两个时间戳前建议用 file_time_type::clock::now() 对齐
• 路径长度限制：Windows MAX_PATH=260（除非启用 long path support），而 Linux 通常为 4096；std::filesystem::path::String() 超长时可能截断，应优先用 u8string() + UTF-8 处理

常见错误：路径拼接出错、权限被忽略、编码隐式转换

最常踩的坑不是功能不存在，而是默认行为不符合直觉：

• 用 + 拼接 path：写成 p + "/sub" 可能生成 "a/b/c/sub"（Linux）或 "abc/sub"（Windows），斜杠混用导致 exists() 返回 false；正确做法是用 / 运算符：p / "sub"
• 直接传 char* 给 path 构造函数：若源字符串含中文且编译器默认编码为 GBK（如 MSVC），会误解析为乱码；应显式用 u8path(u8"中文.txt") 或确保源文件保存为 UTF-8 with bom
• 调用 create_directories(p) 前没检查父目录权限：即使 p 所在磁盘可写，中间某级目录若为只读，该函数抛 filesystem_error 而非静默失败

Windows 下必须开启 long path support 才能处理 >260 字符路径

否则 std::filesystem::exists("C:/very/long/path/...") 直接返回 false，连错误码都不报 —— 这不是库的问题，是 Windows API 层面的限制。

立即学习“C++免费学习笔记（深入）”；

• 程序 manifest 中需声明 longPathAware=true
• 或通过组策略/GPO 启用 “Enable Win32 long paths”（Windows 10 1607+）
• 代码里可加运行时检测：GetFullPathNameA 返回 0 且 GetLastError() == ERROR_INVALID_PARAMETER 时，大概率是触发了 MAX_PATH 限制

跨平台路径逻辑越简单越好，别指望 std::filesystem 替你兜底所有系统边界问题。路径构造、权限控制、错误分类这三步，每一步都得自己盯住。