std::filesystem::equivalent 可靠判断两路径是否指向同一物理文件（如硬链接、解析后符号链接相同），但要求两路径均存在，否则抛 filesystem_error 异常；需先用 exists() 检查，再调用以避免崩溃。
std::filesystem::equivalent 判断路径是否指向同一文件
它能可靠判断两个路径在文件系统层面是否指向同一个物理文件（比如硬链接、符号链接展开后相同），但前提是目标文件必须存在。如果任一路径不存在，std::filesystem::equivalent 会抛出 std::filesystem::filesystem_error 异常，而不是返回 false。
- 必须包含头文件：
#include <filesystem></filesystem>，并链接-lstdc++fs（GCC 早期版本）或启用 C++17 标准（Clang/MSVC 通常默认支持） - 路径参数类型是
std::filesystem::path，不是裸字符串；传入前建议先用std::filesystem::exists()检查存在性，避免异常打断流程 - 对符号链接，默认会解析（即“跟随”），判断的是最终目标是否相同；若需比较链接本身（不解析），得手动处理
read_symlink+ 字符串比对，equivalent不支持该模式 - Windows 下大小写不敏感，Linux/macOS 默认区分大小写——行为取决于底层 OS 的文件系统策略，
equivalent不做额外归一化
常见错误：路径不存在却直接调用 equivalent
最常踩的坑是拿用户输入的路径（比如配置里读出来的 "./data/config.yaml" 或临时生成的 "cache.tmp"）直接喂给 equivalent，结果程序崩溃或被异常捕获逻辑吞掉，误以为“不是同一个文件”，其实是“根本没这个文件”。
- 错误写法：
equivalent(p1, p2)前没检查exists(p1) && exists(p2) - 正确做法：先用
std::filesystem::status()或exists()分别确认，任一不存在就按业务逻辑处理（比如跳过、报错、创建默认） - 注意
status()也可能抛异常（如权限不足），若路径来自不可信来源，应包裹try/catch；但exists()在多数实现中对不存在路径是安全的（返回false）
equivalent 和 ==、compare 的本质区别
== 比较的是路径字符串字面值是否相等（比如 "a/b" 和 "./a/b" 不等）；compare() 是字典序比较；而 equivalent() 是真正的文件系统语义判断——它需要访问磁盘、解析链接、获取 inode（Unix）或 reparse point（Windows）。
- 性能上：
equivalent()是 I/O 操作，可能慢（尤其跨网络文件系统或高延迟存储），别在热循环里反复调用 - 兼容性上：C++17 起标准支持，但某些嵌入式 STL 实现（如旧版 libc++）可能未完整实现；可用
__cpp_lib_filesystem宏检测 - 替代方案有限：没有标准库函数能绕过 I/O 做等价判断；手撸 inode 比较（
stat()）会丢失 Windows 支持，且无法处理符号链接链
一个安全的等价判断封装示例
实际项目中建议封装一层，把存在性检查和异常处理收进去，让调用点干净：
立即学习“C++免费学习笔记（深入）”；
bool safe_equivalent(const std::filesystem::path& a, const std::filesystem::path& b) {
if (!std::filesystem::exists(a) || !std::filesystem::exists(b)) {
return false;
}
try {
return std::filesystem::equivalent(a, b);
} catch (const std::filesystem::filesystem_error&) {
return false;
}
}
注意：这里捕获的是所有 filesystem_error，包括权限拒绝、路径过长等；若需区分错误类型，可检查 e.code().value()，但多数场景“不可判等”就等于“不等”已够用。
真正麻烦的是那些看似等价、实则因挂载点、bind mount、overlayfs 或容器卷映射导致 inode 相同但语义不同的情况——equivalent 会返回 true，但业务上可能要求视为不同。这种边界得靠上层约定或额外元数据标记，标准库管不了。
