应使用 std::filesystem::path 的 / 运算符而非 append() 进行跨平台路径拼接，因其返回新路径、自动处理分隔符与归一化，避免就地修改、非法组件异常及根路径覆盖等问题。
std::filesystem::path 的 / 运算符才是跨平台拼接的正确姿势
别用 append() 做路径拼接，它不返回新路径，而是就地修改原对象，且语义是“追加路径组件”，不是“拼接字符串”。真正该用的是重载的 / 运算符——它返回新 std::filesystem::path，自动处理分隔符（Windows 用 ，其他用 /），且对空字符串、开头的 / 或 .. 等有合理归一化行为。
常见错误现象：path.append("subdir").append("file.txt") 看似链式调用，但一旦中间某次 append() 输入非法组件（比如含 或控制字符），会抛 std::filesystem::filesystem_error；更隐蔽的是，如果传入带根的路径如 "C:\temp"，append() 会直接替换整个路径，而非拼接。
-
/运算符支持任意数量的操作数：base / "sub" / "file.txt"，可读性高，且每个操作数都会被当作独立组件处理 -
append()只接受单个组件或迭代器范围，不能直接拼接完整子路径字符串（如"sub/file.txt"）——它会把斜杠当普通字符，导致 Windows 下生成C:sub/file.txt这种混合分隔符的非法路径 - 性能上无明显差异，但
/更少出错：它内部调用concat()+make_preferred()，而append()是纯组件追加，不自动 normalize
std::filesystem::path 构造时的字符串格式陷阱
构造 std::filesystem::path 对象时，原始字符串的写法直接影响后续拼接结果。不是所有看起来像路径的字符串都能安全参与 / 拼接。
使用场景：从配置文件读取路径片段、拼接用户输入目录与固定文件名、组合模块路径等。
立即学习“C++免费学习笔记（深入）”；
- 避免直接用字面量
"C:/data"构造：虽然/运算符能自动转为，但若该字符串本身含（如"C:\data"），在非 Windows 平台可能被误解析为转义序列 - 推荐统一用 raw string literals：
R"(C:data)"或R"(/usr/local)"，彻底规避转义问题 - 绝对路径字符串（如
"/home/user"或"C:\temp"）参与/拼接时，会覆盖左侧路径——这是标准行为，不是 bug。例如：path("/a") / "/b"结果是"/b"，不是"/a/b" - 若需强制相对拼接，先调用
.relative_path()或用.lexically_normal()清理再拼
Windows 下 std::filesystem::path 的大小写与长路径兼容性坑
Windows 文件系统默认不区分大小写，但 std::filesystem::path 的字符串视图仍保留原始大小写；更重要的是，长路径（>260 字符）支持需要显式启用，否则 / 拼接后调用 exists() 或 create_directories() 会静默失败或抛异常。
常见错误现象：(base / "very/long/nested/path").exists() 返回 false，即使路径真实存在；或者 create_directories() 报 Operation not permitted。
- 确保编译时定义
_CRT_SECURE_NO_WARNINGS和_SCL_SECURE_NO_WARNINGS（MSVC），并启用长路径支持：在程序启动前调用SetCurrentDirectory(L"\\?\C:\your\base")或在 manifest 中声明longPathAware=true - 不要依赖
path.string()做大小写比较——用std::filesystem::equivalent()判断是否指向同一位置 -
/拼接后的路径，若含 Unicode 字符（如中文目录名），必须用.u8string()或.wstring()传给系统 API，不能用.string()（可能乱码或截断）
构建可移植路径工具时，别绕过 std::filesystem 自己拼字符串
有人为“保险”手动判断平台、替换分隔符、拼接字符串，这反而引入更多 bug。标准库的 std::filesystem::path 已经封装了所有平台细节，强行绕过等于放弃它的核心价值。
性能影响：自己拼字符串看似快，但每次都要做条件分支、内存分配、字符转换；而 std::filesystem::path 的 / 运算符是轻量级对象构造，底层用引用计数或 small-string 优化，实测开销可忽略。
- 禁止写
os == "win" ? a + "\" + b : a + "/" + b这类逻辑——std::filesystem::path的/就是为此存在 - 禁止对
path对象调用.c_str()后手动处理——它的c_str()返回的是内部编码，应直接传给std::filesystem函数，或用.u8string().c_str()传给 POSIX API - 若需日志输出路径，用
path.string()或path.u8string()，别用path.native()（返回平台原生编码，Windows 是 UTF-16，Linux 是 locale-dependent）
最易被忽略的一点：std::filesystem::path 的隐式转换很危险——比如把 path 直接传给接受 const char* 的旧函数，会触发临时 std::string 构造，但该临时对象生命周期只到当前表达式结束，导致悬垂指针。必须显式保存为变量再取 .c_str()。
