最可靠的方法是Windows调用GetFileInformationByHandle比对卷序列号和文件索引，POSIX调用stat()比对st_dev与st_ino；std::filesystem::equivalent虽封装原生逻辑，但不支持跨主机NFS且对悬空符号链接行为不一致。
Windows下用GetFileInformationByHandle比对文件ID和卷序列号
在Windows上，仅靠字符串相等或std::filesystem::equivalent（C++17）还不够稳妥——比如符号链接、挂载点、UNC路径映射到本地驱动器时，路径字符串不同但指向同一文件。最可靠的方式是打开两个路径，获取其句柄后调用GetFileInformationByHandle，比对dwVolumeSerialNumber、nFileIndexHigh和nFileIndexLow三者是否完全一致。
注意：必须以相同访问权限（如GENERIC_READ）打开，且不能用FILE_FLAG_OPEN_REPARSE_POINT跳过重解析点，否则可能绕过符号链接/目录交接点，导致误判。若任一路径不存在、无权限或被删除，函数会失败，需检查GetLastError()是否为ERROR_FILE_NOT_FOUND或ERROR_ACCESS_DENIED。
示例关键片段：
HANDLE h1 = CreateFileA(path1.c_str(), GENERIC_READ, FILE_SHARE_READ, nullptr, OPEN_EXISTING, 0, nullptr);
if (h1 == INVALID_HANDLE_VALUE) return false;
BY_HANDLE_FILE_INFORMATION info1;
GetFileInformationByHandle(h1, &info1);
CloseHandle(h1);
// 同理处理path2 → info2
bool same = (info1.dwVolumeSerialNumber == info2.dwVolumeSerialNumber) &&
(info1.nFileIndexHigh == info2.nFileIndexHigh) &&
(info1.nFileIndexLow == info2.nFileIndexLow);
Linux/macOS用stat()比较st_dev和st_ino
POSIX系统下，stat()返回的st_dev（设备ID）和st_ino（inode号）联合唯一标识一个文件实体。只要两者都相等，就一定是同一个文件——无论硬链接、相对路径、./前缀还是挂载点内的路径。
立即学习“C++免费学习笔记（深入）”；
常见坑点：
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
-
lstat()不跟随符号链接，stat()会跟随；判断“最终指向”应统一用stat()（否则符号链接本身和目标会被判为不同） - 跨文件系统（如
/home和/tmp挂载在不同设备）时，st_dev必然不同，无需再比st_ino - 某些网络文件系统（如NFSv2）可能不保证
st_ino全局唯一，但现代Linux/NFSv4、ext4、APFS均可靠
简写逻辑：
struct stat s1, s2; if (stat(path1.c_str(), &s1) != 0 || stat(path2.c_str(), &s2) != 0) return false; return (s1.st_dev == s2.st_dev) && (s1.st_ino == s2.st_ino);
C++17 std::filesystem::equivalent的适用边界与陷阱
这个函数封装了平台原生逻辑，看起来最省事，但它有明确限制：
- Windows下内部仍调用
GetFileInformationByHandle，但会自动处理路径规范化（如\?前缀、大小写），可靠性高 - Linux/macOS下实际调用
stat()，行为同上 - 但它**不处理跨主机的NFS路径**（比如
host:/path这种非本地挂载路径），会直接失败并抛std::filesystem::filesystem_error - 若任一路径是断开的符号链接（dangling symlink），部分实现（如libstdc++）可能抛异常而非返回
false，需用std::error_code重载版本捕获
安全用法：
std::error_code ec;
bool eq = std::filesystem::equivalent(p1, p2, ec);
if (ec) { /* 处理ec.value()，如ec.value() == std::errc::no_such_file_or_directory */ }
跨平台封装时必须避开的三个典型错误
写通用函数时，最容易栽在这几个地方：
- 直接用
std::filesystem::canonical()再字符串比较——canonical()不解决硬链接问题，两个硬链接的canonical路径不同，但它们是同一文件 - 只比对
st_ino忽略st_dev——同一inode号在不同设备上可能重复，尤其容器环境或tmpfs挂载 - Windows下用
GetFinalPathNameByHandle转成\?路径再字符串比较——它不处理硬链接，且对某些重解析点（如WOW64文件系统重定向）返回不可预测结果
真正跨平台健壮的做法，是按OS分支调用原生API：Windows走GetFileInformationByHandle，POSIX走stat()，不试图用单一C++标准库接口掩盖底层差异。
