std::filesystem::path 天然跨平台，但需确保输入为 UTF-8、正确处理错误、避免手动拼接路径；目录遍历应使用标准迭代器并设置跳过权限错误；创建目录后应显式设权限；复制/移动需明确指定 copy_options；错误处理须检查 error_code 具体值。
直接用 std::filesystem::path 就行，它天然屏蔽 Windows 和 POSIX 路径分隔符、盘符、大小写语义等差异；但前提是别手动拼字符串、别忽略编码和错误处理——否则跨平台只是假象。
路径构造必须用 UTF-8 字符串，别用宽字符或本地编码
Windows API 内部用 UTF-16，但 std::filesystem 的所有构造函数（如 path(const char*)）都按 UTF-8 解释输入。如果你在 Windows 上从 GetCommandLineW() 或 argv 拿到本地编码（如 GBK），直接传给 path 会导致中文路径解析失败或乱码。
- ✅ 正确做法：确保所有输入字符串是 UTF-8 编码。Linux/macOS 默认就是；Windows 需显式转换，例如用
WideCharToMultiByte(CP_UTF8, ...)或 C++20 的std::osyncstream配合std::codecvt_utf8（已弃用，推荐用第三方轻量转换） - ❌ 错误现象：
fs::exists("C:\用户\文档\test.txt")返回false，即使路径真实存在——大概率是源字符串实际为 GBK 编码，被当作 UTF-8 解析后字节序列非法 - ⚠️ 注意：
path::string()返回std::string（UTF-8），path::wstring()返回std::wstring（Windows 是 UTF-16，Linux/macOS 可能为空或抛异常），生产代码中尽量只用前者
目录遍历要用 directory_iterator 或 recursive_directory_iterator，别手写递归
手写递归遍历容易漏掉符号链接循环、权限拒绝、挂载点穿越等问题；标准迭代器内置了错误跳过策略和路径规范化能力。
- ✅ 推荐遍历方式：
for (const auto& entry : fs::directory_iterator(p))—— 非递归，只扫一级；for (const auto& entry : fs::recursive_directory_iterator(p, fs::directory_options::skip_permission_denied))—— 递归且自动跳过无权访问的子目录 - ❌ 常见陷阱：不传
fs::directory_options::skip_permission_denied，遇到/proc或/root下的受限目录时直接抛filesystem_error异常，中断整个遍历 - ? 性能提示：
recursive_directory_iterator构造时会预读部分条目，首次解引用可能较慢；若只需判断是否存在某类文件，优先用fs::exists()+fs::is_regular_file()组合，避免全量遍历
create_directories() 能跨平台建多级目录，但权限继承不可靠
fs::create_directories("a/b/c") 在 Windows 和 Linux 上都可用，且会自动创建中间缺失的 a 和 b；但它不保证新目录的权限位与父目录一致——尤其在 Linux 上，默认 umask 会影响结果。
立即学习“C++免费学习笔记（深入）”；
- ✅ 安全做法：创建后显式设置权限，例如
fs::permissions(p, fs::perms::owner_all | fs::perms::group_read | fs::perms::group_exec, fs::perm_options::replace) - ❌ 错误假设：认为
create_directories()创建的目录一定可写或可遍历；实际在某些容器环境或严格 umask 设置下，新目录可能只有rwx------ - ⚠️ 符号链接注意：如果
a是个符号链接，create_directories("a/b/c")会在链接目标下建目录，不是在链接本身路径下——这是 POSIX 语义，Windows 同样模拟该行为
移动/复制文件前先检查目标是否可覆盖，fs::copy() 的 copy_options 很关键
fs::copy(src, dst) 默认行为是“仅当 dst 不存在时才复制”，这跟 shell 的 cp 完全不同；不加选项直接调用，容易在预期覆盖时静默失败。
- ✅ 明确意图：覆盖用
fs::copy(src, dst, fs::copy_options::overwrite_existing)；跳过已存在且内容相同的文件用fs::copy_options::skip_existing；保留时间戳和权限用fs::copy_options::copy_symlinks | fs::copy_options::recursive - ❌ 典型误用：
fs::copy("a/", "b/", fs::copy_options::recursive)在b/已存在时会失败（除非加overwrite_existing），而很多人以为它会自动合并目录 - ? 跨文件系统移动（
fs::rename）不保证原子性：若 src 和 dst 在不同磁盘上，rename实际退化为“复制+删除”，中途失败会导致数据丢失；生产环境应改用fs::copy()+fs::remove_all()并加事务日志
最易被忽略的是错误处理粒度——fs::copy() 或 fs::recursive_directory_iterator 抛出的 filesystem_error 包含具体 error_code（如 permission_denied、no_such_file_or_directory），但很多人只 catch 顶层异常，没 inspect .code().value() 去区分是权限问题还是路径错，导致调试时反复重试同一类错误。
