C++判断路径是否为硬链接方法

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() 更底层，但也更易出错。关键点：

• 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。