std::filesystem::path::make_preferred仅替换分隔符而不修复语义错误，不验证存在性、不处理相对路径歧义、不简化../或./；需先用lexically_normal()归一化，跨平台拼接应使用/=运算符，UTF-8路径须用u8string构造，注意各标准库实现差异。
std::filesystem::path::make_preferred 不能自动修复路径语义错误
它只做分隔符替换，不验证路径是否存在、不处理相对路径歧义、不标准化 ../ 或 ./。比如 "a/b/../c" 调用 make_preferred() 后变成 "a..c"（Windows 下），但依然含逻辑冗余，没真正“简化”。
常见误用场景：用户以为调用一次就能安全传给 fopen() 或 CreateFileA()，结果在 Windows 上因路径未规范而打开失败。
- 仅在已确认路径结构合法的前提下，用它统一视觉风格
- 若原始路径来自用户输入或网络，先用
lexically_normal()归一化逻辑 - Windows 下注意：某些旧 API（如
SHGetPathFromIDList()）仍可能拒绝反斜杠开头的 UNC 路径，此时需额外判断并补"\\"
跨平台拼接路径时，别手动拼字符串 + 分隔符
写 dir + "/" + filename 或 dir + "\" + filename 是典型反模式。不仅平台耦合，还会在 dir 末尾已有分隔符时产生双斜杠（如 "data//file.txt"），部分文件系统虽容忍，但 std::filesystem::exists() 在某些 libc++ 版本下会误判为不存在。
正确做法是全程使用 std::filesystem::path 的运算符重载：
立即学习“C++免费学习笔记（深入）”；
std::filesystem::path p = "data"; p /= "subdir"; // 自动用当前平台 preferred separator p /= "config.json"; // 结果在 Windows 是 "data\subdir\config.json"，Linux 是 "data/subdir/config.json"
-
/=和/运算符会自动跳过多余分隔符，避免重复 - 构造时传入含混合分隔符的字符串（如
"a/b\c"）也能被内部 normalize - 不要对
path对象调用.string()再拼接——这等于退化回 C 风格字符串操作
Windows 下读取路径字符串后，必须用 u8string() 而非 string() 处理 UTF-8 输入
如果路径来自 Qt、WinAPI 的 GetOpenFileNameW() 或 JSON 解析（UTF-8 编码），直接用 std::string 构造 std::filesystem::path 可能触发未定义行为：MSVC 的 std::filesystem 实现对窄字符串默认按本地 ANSI 编码解释，中文路径大概率乱码或构造失败。
安全做法：
- 从宽字符来：用
std::filesystem::path{wstring}（如 Qt 的toStdWString()） - 从 UTF-8 字节流来：显式用
std::filesystem::path{u8string}，例如std::filesystem::path{u8"项目/配置.json"} - 避免
path.string().c_str()传给旧 API；优先用path.u8string().c_str()或path.wstring().c_str()
CI/CD 中测试路径行为，要覆盖不同 filesystem 实现差异
libstdc++（GCC）、libc++（Clang）和 MSVC STL 对 std::filesystem 的错误码映射、路径最大长度截断、甚至 is_absolute() 判断逻辑都有细微差别。例如 "C:file.txt" 在 MSVC 下是相对路径，在 libstdc++ 下可能被识别为绝对路径。
关键检查点：
- 用
std::filesystem::status()替代裸access()，它跨平台返回统一std::filesystem::file_status - 测试时在 CI 中启用不同标准库（如 GitHub Actions 的
ubuntu-latest+ GCC vswindows-latest+ MSVC） - 避免依赖
path.native()的具体字符串格式；它只是实现定义的“适合当前 OS”的表示，不是可移植文本
最易被忽略的是：make_preferred() 在 Linux/macOS 下其实什么也不做——它返回原路径，但开发者常误以为它“总会改点什么”，从而漏掉对非 Windows 路径的逻辑分支校验。
