std::filesystem::equivalent 是 C++ 标准库中唯一能正确检测硬链接的函数，它通过 stat() 比较 st_dev 和 st_ino 判断是否指向同一文件实体，不解析符号链接，且要求路径存在可访问。
硬链接的本质是 inode 相同，不是路径字符串相等
在 C++ 中，std::filesystem::equivalent 是唯一标准库函数能直接判断两个路径是否指向同一文件系统实体（包括硬链接）。它底层依赖 stat() 系统调用比较 st_dev 和 st_ino 字段。注意：它**不检查符号链接目标**，而是解析后比对真实 inode —— 这正是硬链接检测的正确方式。
常见误区是用 std::filesystem::canonical 后字符串比较，这既慢又错：硬链接路径可以跨目录层级，且 canonical 对硬链接本身无意义（它们本就指向同一 inode）；更糟的是，若路径含未解析的符号链接，canonical 会跟随它，导致误判。
使用 std::filesystem::equivalent 的前提和限制
该函数要求两个路径都存在且可访问（否则抛 std::filesystem::filesystem_error）。它不能告诉你“为什么不等价”——比如是不同文件、权限不足，还是跨文件系统（硬链接根本不可能跨设备）。
- 必须包含
-lstdc++fs（GCC 旧版本）或启用 C++17 标准（Clang/MSVC 通常默认支持） - 若任一路径是悬空符号链接，
equivalent会失败（errno = ENOENT），不会自动忽略符号链接层 - 无法区分硬链接与同一文件的多个打开句柄——它只回答“是否同一文件”，不关心链接类型
try {
bool same_file = std::filesystem::equivalent("/path/to/link1", "/path/to/link2");
if (same_file) {
// 二者是硬链接（或同一路径的多次解析）
}
} catch (const std::filesystem::filesystem_error& e) {
// 路径不存在、无权限、跨文件系统（但此时 equivalent 应返回 false，而非抛异常？注意：实际行为依实现而定，GCC 通常返回 false，MSVC 可能抛）
}
手动比对 inode 需要处理的细节
绕过 equivalent 直接调用 stat() 更底层，但也更易出错。关键点：
立即学习“C++免费学习笔记（深入）”；
-
stat()不解析符号链接，lstat()才获取链接自身元数据——硬链接检测必须用stat()，否则得到的是符号链接文件的 inode，不是目标文件的 - 必须同时比较
st_dev（设备号）和st_ino（inode 号）：不同设备上 inode 号可能重复，仅比 inode 会误判 - Windows NTFS 无传统 inode，
std::filesystem::equivalent在 Windows 上通过文件 ID + 卷序列号模拟等价性，手动实现需调用GetFileInformationByHandle
struct stat st1, st2;
if (stat("/path/a", &st1) == 0 && stat("/path/b", &st2) == 0) {
bool is_hardlink = (st1.st_dev == st2.st_dev) && (st1.st_ino == st2.st_ino);
}
硬链接检测失败的典型原因
即使两个路径确实是硬链接，equivalent 也可能返回 false：
- 路径之一被
chroot或挂载命名空间隔离，导致内核返回不同设备号（st_dev） - 其中一个路径位于 bind mount 或 overlayfs 下层，文件系统报告的
st_dev可能不一致 - 使用了
std::filesystem::path构造时未标准化路径（如含"./"或"../"），虽不影响equivalent内部逻辑，但若前置做了错误的字符串比较，会干扰调试 - 权限问题：进程对某个路径的父目录无执行（
x）权限，则stat失败，equivalent抛异常或返回false
真正难排查的是跨文件系统场景：硬链接根本不可能存在，但用户误以为可以，此时 equivalent 返回 false 是正确行为，不是 bug。
