/ 运算符比 += 更安全，能自动处理路径分隔符；canonical() 易失败，需 try/catch；relative_path() 与 parent_path() 语义不同；Windows 下优先用 u8string() 避免编码问题。
path 构造和拼接时，/ 运算符比 += 更安全
直接用 += 拼字符串容易忽略路径分隔符逻辑，比如 p += "sub" 在 p 末尾已有斜杠时会生成重复分隔符（/a//sub）；而 / 运算符自动处理边界：无论 p 是否以 / 结尾，p / "sub" 都生成合法路径。它内部调用 operator/=，会先移除右操作数开头的根名或多余斜杠，再拼接。
实操建议：
- 始终优先用
/拼接子路径，如std::filesystem::path p = "/home" / "user" / ".config" - 避免对
path对象做+=或+= string_view，除非你明确控制右侧不含前导分隔符 - 若需动态拼接，先转成
path再用/：比如p / std::filesystem::path{subdir}，而非p += "/" + subdir
canonical() 失败很常见，别假设它总能成功
std::filesystem::canonical() 要求所有中间路径组件都存在且可访问，只要某一级目录不存在、权限不足、是损坏符号链接或跨文件系统挂载点，就会抛出 std::filesystem::filesystem_error。它不是“美化路径”，而是真实解析到绝对物理路径。
常见错误现象：
立即学习“C++免费学习笔记（深入）”；
- 开发机上跑通，CI 环境因缺少目录结构而崩溃
- 传入相对路径如
"../data/file.txt"，但当前工作目录下没有对应上级目录 - 路径含环境变量占位符（如
$HOME）——canonical()完全不展开它们
实操建议：
- 用前必须
try/catch，捕获std::filesystem::filesystem_error - 若只需“标准化格式”（去
.、..、双斜杠），改用std::filesystem::weakly_canonical()—— 它对缺失路径组件更宽容，只规范化已存在的部分 - 调试时打印
.string()和.is_absolute()，确认输入路径状态
relative_path() 和 parent_path() 的语义差异易混淆
parent_path() 返回去掉最后一个路径组件后的路径（不含末尾斜杠），而 relative_path() 是从根目录起、不包含根名（root_name）和根目录（root_directory）的剩余部分。例如路径 "C:/foo/bar.txt"（Windows）中：parent_path() 是 "C:/foo"，relative_path() 是 "foo/bar.txt"。
使用场景：
- 要获取上层目录做递归遍历，用
parent_path() - 要提取“相对于挂载点”的路径（如容器内映射路径），用
relative_path() - 在跨平台代码中，
relative_path().empty()可判断是否为根路径（如"/"或"C:/"），比检查filename() == ""更可靠
注意：relative_path() 不等价于 “去掉 root_path()”，因为 root_path() 包含 root_name() + root_directory()，而 relative_path() 还排除了卷标或 UNC 主机名等。
path::string() 和 path::generic_string() 的编码陷阱
在 Windows 上，path::string() 返回 std::string，但底层存储是 UTF-16，转换可能丢失非 ASCII 字符（尤其中文路径）；path::generic_string() 则返回按通用语法（正斜杠）格式化的字符串，且在 Windows 上仍走 UTF-8 编码路径（前提是编译器支持，如 MSVC 19.29+ 或 GCC 11+ 启用 -fchar8_t）。
实操建议：
- Windows 下涉及中文或 Unicode 路径，优先用
path::u8string()（返回std::u8string）或path::generic_u8string() - 写日志或调试输出时，直接用
path对象流输出（std::cout ），它自动调用 <code>generic_string()并正确转义 - 调用 C API（如
fopen）时，Windows 必须用wstring()+_wfopen，Linux/macOS 用string()+fopen；不要无条件传string().c_str()
跨平台路径处理最麻烦的从来不是拼接或规范化，而是字符编码落地那一刻——一个没显式指定宽字符的 fopen 调用，足以让整个路径逻辑在中文 Windows 上静默失败。
