std::filesystem::equivalent仅在两路径指向同一文件系统对象（如相同inode或file_id）时返回true，它解析符号链接后比对底层标识，路径不存在或无权限时抛filesystem_error而非返回false。
std::filesystem::equivalent 什么时候返回 true
它只在两个路径指向**同一个文件系统对象**（比如同一文件、同一目录）时才返回 true，不是看路径字符串是否相同，也不是看是否“逻辑等价”（如 "./file.txt" 和 "file.txt"）。底层依赖操作系统提供的等价性检查（如 Linux 的 stat() 比较 st_dev + st_ino，Windows 的 GetFileInformationByHandle）。如果任一路径不存在、无权限访问或跨文件系统（比如一个在 /home，另一个在挂载的 USB 设备上），它会抛出 std::filesystem::filesystem_error。
必须捕获 filesystem_error 异常
这是最容易被忽略的坑：只要有一个路径无效，std::filesystem::equivalent 就直接抛异常，而不是返回 false。你不能靠返回值判断“不等价”，得先确保路径合法可访问。
- 常见错误现象：
terminate called after throwing an instance of 'std::filesystem::filesystem_error' - 正确做法：用
try/catch包裹，或提前用std::filesystem::exists()和std::filesystem::is_regular_file()等做预检 - 注意：
exists()本身也可能抛异常（如权限不足），所以预检不等于完全规避异常
示例：
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
try {
bool same = std::filesystem::equivalent(p1, p2);
} catch (const std::filesystem::filesystem_error& e) {
// e.what() 会包含具体失败原因，比如 "No such file or directory"
}
符号链接处理很关键
std::filesystem::equivalent 默认**解析符号链接**——也就是说，它比较的是链接最终指向的目标，不是链接本身。如果你需要判断两个符号链接文件是否是“同一个链接文件”，而不是它们指向同一目标，这个函数就不适用。
- 场景举例：
ln -s /tmp/a link1和ln -s /tmp/a link2→equivalent(link1, link2)返回true - 但
link1和link2是两个独立的 inode，只是内容相同；如果你要区分它们，得用std::filesystem::status()+symlink_status()对比file_status的底层信息 - 没有内置开关跳过解析；想绕过解析，只能手动读取链接路径再比对字符串（但这不等价于文件系统等价性）
跨分区/挂载点一定返回 false 或抛异常
Linux/macOS 下，不同挂载点（比如 / 和 /mnt/usb）必然属于不同文件系统，equivalent 会立即抛异常（因为 stat() 失败或 st_dev 不同）；Windows 下不同驱动器盘符（C: vs D:）同理。它不会尝试“逻辑归一化”路径或模拟等价。
- 不要指望它能识别
/home/user/../user/file.txt和/home/user/file.txt的等价性——这由std::filesystem::canonical()处理，不是equivalent的职责 - 若需健壮判断，典型组合是：
canonical(p1) == canonical(p2)（注意：canonical同样可能抛异常） -
equivalent的价值在于精确反映 OS 层面的“同一对象”，而非路径规范化
真正难处理的从来不是怎么调用，而是你得清楚自己到底要判断“是不是同一个 inode”，还是“路径规整后是否一样”。前者用 equivalent，后者得自己 canonical + ==，而且两者异常路径完全不同。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
