c++oding="utf-8" ?>
std::filesystem::canonical 返回不存在符号链接的绝对路径，但不补全相对路径前缀；需确保路径可达并捕获 filesystem_error 异常。
canonical 会解析符号链接但不处理相对路径前缀
std::filesystem::canonical 的核心作用是：从一个路径出发，沿着文件系统逐级解析，最终返回该路径对应的、不存在符号链接的绝对路径。但它**不会自动补全当前工作目录**——如果输入是相对路径（比如 "./data/config.txt"），它会先尝试以当前工作目录为基准解析，但前提是这个相对路径在当前上下文中能被完整定位。一旦中间某一级不存在或不可访问，就会抛出 std::filesystem::filesystem_error。
常见错误现象：canonical("foo") 在当前目录下没有 foo 时直接崩溃；canonical("../out") 若上层目录不可读也会失败。
- 必须确保输入路径在文件系统中“可达”——即所有父目录存在且可遍历
- 若只想转成绝对路径而不解析符号链接，用
std::filesystem::absolute更安全 -
canonical对软链接敏感，比如/usr/bin/python3可能被展开为/usr/bin/python3.11
调用 canonical 前要捕获 filesystem_error
几乎所有实际场景中，你无法 100% 确保传入路径一定存在或可解析。C++ 标准规定 canonical 在失败时抛出 std::filesystem::filesystem_error，而不是返回空路径或错误码。忽略异常会导致程序终止。
示例：
try {
auto abs_path = std::filesystem::canonical("config.yaml");
std::cout
- 不要用
std::filesystem::exists()预检代替异常捕获——竞态条件下仍可能失败 - 若需静默失败，可封装一层返回
std::optional<:filesystem::path></:filesystem::path> - 注意：MSVC 和 libstdc++ 对某些边缘路径（如跨驱动器的 Windows 符号链接）行为略有差异
Windows 下 drive letter 必须显式指定
在 Windows 上，canonical 要求输入路径包含盘符（如 "C:/temp/../file.txt"），否则会报错 std::errc::invalid_argument。即使你在 C: 盘当前目录下运行，传入 "temp/file.txt" 也会失败——它不默认补 C:。
- 安全做法：先用
std::filesystem::absolute转成带盘符的绝对路径，再传给canonical - 例如：
std::filesystem::canonical(std::filesystem::absolute("data/log.txt")) - MinGW 和 MSVC 在处理 UNC 路径（
"\\server\share"）时都支持，但需确保网络可达
canonical 不等价于 realpath -m
Linux 的 realpath -m（missing）允许路径末尾不存在的组件，只解析已存在的部分；而 std::filesystem::canonical 要求**整个路径链都存在**（除了最后一个组件可以是文件/目录名）。也就是说，canonical("a/b/c") 要求 a 和 a/b 都存在，哪怕 c 是个待创建的文件名。
- 若目标是“规范路径字符串”（比如统一斜杠、折叠
../），用std::filesystem::weakly_canonical更合适 -
weakly_canonical("a/../b")→"b"，即使a不存在也不会抛异常 - 但
weakly_canonical不解析符号链接，也不保证结果是绝对路径
真正需要 canonical 的场景其实很窄：验证配置路径是否真实指向某个可访问位置，并消除软链接歧义。多数时候，你只是想把用户输入变成稳定路径，absolute 或 weakly_canonical 更实用，也更不容易崩。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
