std::filesystem::canonical 返回存在且规范化的绝对路径，递归解析符号链接并要求所有上级目录真实存在，否则抛出异常；应优先使用带 std::error_code 参数的重载版本以安全处理错误。
canonical 会解析符号链接并返回绝对路径
std::filesystem::canonical 的核心作用是：从任意路径（相对、绝对、含 .. 或符号链接）出发，递归解析所有符号链接，并向上追溯父目录直到找到真实存在的路径，最终返回一个**存在且规范化的绝对路径**。它不是简单拼接 std::filesystem::absolute，而是依赖文件系统实际状态——如果中间某级目录不存在，就会抛出 std::filesystem::filesystem_error。
常见错误现象：canonical("nonexistent/") 直接崩溃；canonical("symlink_to_dir/./file.txt") 返回目标文件的真实位置而非 symlink 路径本身。
- 必须确保路径的**所有上级目录都真实存在**，否则抛出异常（错误码为
std::errc::no_such_file_or_directory） - 若路径末尾是符号链接，
canonical解析后返回其指向的目标路径（不是链接本身的路径） - 不支持对不存在的文件末尾做解析（比如
canonical("dir/file.txt")中file.txt不存在，但dir存在——这是允许的；但如果dir也不存在，就失败）
如何安全调用 canonical 避免异常中断
直接裸调 std::filesystem::canonical(path) 在生产代码中风险很高。推荐始终配合 std::error_code 重载版本，并检查返回值是否有效。
<pre class="brush:php;toolbar:false;">std::filesystem::path p = "some/relative/path";
std::error_code ec;
auto abs_path = std::filesystem::canonical(p, ec);
if (ec) {
// 处理错误，例如：ec.message() 可能是 "No such file or directory"
return std::nullopt; // 或抛出自定义异常、记录日志等
}
// 此时 abs_path 是合法的规范绝对路径
- 永远优先使用带
std::error_code& 参数的重载，而不是无异常版本 - 不要依赖
std::filesystem::exists(abs_path)后再调canonical—— 因为exists不检查中间路径，而canonical会检查整条路径链 - 若需处理“路径可能不存在”的场景，应先用
std::filesystem::status(path, ec)判断是否存在或是否为 symlink，再决定是否调用canonical
canonical 与 absolute、weakly_canonical 的关键区别
这三个函数常被混淆，但语义完全不同：
-
std::filesystem::absolute(path)：仅将相对路径转为绝对路径，不做任何存在性检查或符号链接解析（比如absolute("foo/../bar")返回/current/dir/bar，哪怕foo不存在） -
std::filesystem::weakly_canonical(path)：只规范化路径结构（折叠./、../），不解析符号链接，也不要求路径存在——适合预处理路径字符串 -
std::filesystem::canonical(path)：要求路径存在、解析所有 symlink、返回真实磁盘上的绝对路径——代价最高，但也最“真实”
性能影响明显：canonical 涉及多次 stat() 系统调用，尤其在深层嵌套或跨挂载点时延迟更显著；weakly_canonical 是纯字符串操作，快几个数量级。
Windows 下要注意路径大小写和驱动器号
Windows 文件系统默认不区分大小写，但 std::filesystem::canonical 返回的路径会按磁盘上实际存储的大小写呈现（比如注册表里存的是 C:UsersJohnDoe，那返回的就是这个大小写形式）。另外，它总会补全驱动器号——即使输入是 "\server\share\file" 这样的 UNC 路径，也会正常处理；但若输入是 "subdir\file.txt" 且当前工作目录在 D: 盘，则返回 D:\subdir\file.txt。
- 不要假设返回路径的大小写和输入一致，尤其在做哈希或路径比较时应统一转小写或用
std::filesystem::equivalent - UNC 路径（
\\host\share）在 Windows 上可被正确 canonical 化；Linux 不支持，会报错 - 跨分区或网络驱动器时，
canonical可能失败（如权限不足、远程不可达），务必通过std::error_code捕获具体原因
真正麻烦的不是怎么写这行代码，而是你得清楚自己到底要“逻辑路径规范化”还是“物理路径定位”——选错函数，后面所有路径比较、缓存、权限判断都可能出偏。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
