std::filesystem::equivalent() 是判断两路径是否指向同一文件系统实体的最直接、标准且跨平台的方式，它自动解析符号链接、处理相对路径、比较底层 inode（Linux/macOS）或 FileID（Windows），但要求两路径均存在，否则抛 filesystem_error 异常。
用 std::filesystem::equivalent() 是最直接的方式
Windows 和 Linux/macOS 上判断两个路径是否指向同一文件系统实体，std::filesystem::equivalent() 是标准且跨平台的解法。它会解析符号链接、处理相对路径、比较真实 inode（Linux/macOS）或 FileID（Windows），无需手动 normalize 或 resolve。
常见错误是只比对字符串相等（path1 == path2）或只调用 std::filesystem::canonical() 后再比较——前者漏掉软链/相对路径场景，后者在路径不存在时抛异常，且某些 Windows 网络路径下 canonical() 可能失败。
-
std::filesystem::equivalent()要求两个路径都存在，任一不存在则抛std::filesystem::filesystem_error - 若需容错（比如一个路径可能暂未创建），应先用
exists()预检，再决定是否调用equivalent() - 注意：该函数不处理硬链接跨文件系统的情况（但这种情况本身在多数场景已属边缘）
Windows 下用 GetFileInformationByHandle() 更底层但可控
当需要绕过 C++ 标准库限制（如旧编译器不支持 C++17 filesystem）、或需和已有 Win32 代码集成时，可直接用系统 API 获取文件唯一标识。核心是打开两个路径对应的句柄，再调用 GetFileInformationByHandle() 比较 dwVolumeSerialNumber + nFileIndexHigh + nFileIndexLow。
关键点在于必须以 FILE_FLAG_BACKUP_SEMANTICS 打开目录，且对符号链接要控制 dwFlagsAndAttributes（默认跟随，设 FILE_FLAG_OPEN_REPARSE_POINT 可获取链接自身信息）。
立即学习“C++免费学习笔记（深入）”；
- 路径字符串需转为宽字符（
std::wstring），并确保使用 UNC 格式或前缀\\?\绕过 MAX_PATH 限制 - 若任一句柄打开失败（例如权限不足、路径不存在），无法继续比较，需按业务逻辑 fallback
- 该方法不依赖 STL，但完全失去跨平台性，Linux/macOS 需换用
stat()+st_dev/st_ino
Linux/macOS 下用 stat() 比较 st_dev 和 st_ino
POSIX 系统中，每个文件由设备号 st_dev 和索引节点号 st_ino 唯一标识。调用 stat()（或更安全的 statx()）获取两者，全等即为同一文件。
注意 lstat() 和 stat() 的区别：前者不跟随符号链接，适合判断“链接文件本身是否相同”；后者跟随，适合判断“目标文件是否相同”。多数场景用 stat()。
- 路径需为 UTF-8 编码的
const char*，C++ 中通常用.c_str()传入 - 若路径含中文或特殊字符，确保程序 locale 设置正确，否则
stat()可能返回ENOENT -
stat()对不存在路径返回 -1 并设errno，务必检查返回值，不能只看结构体内容
为什么不用 canonical() + 字符串比较？
看似简单，实则隐患密集：canonical() 在路径不存在时报错，对挂载点、bind mount、overlayfs 等 Linux 高级文件系统行为不可靠，Windows 上对某些 OneDrive/WSL 路径也常失败。即使成功，结果字符串仍可能因大小写、分隔符（/ vs \）、尾部斜杠差异而误判。
更隐蔽的问题是性能：每次 canonical() 都需逐级 stat() 直到根，路径越深开销越大；而 equivalent() 内部可优化（如先比 inode，不匹配再 fallback）。
- 仅当明确知道所有路径都存在、且文件系统行为简单（如本地 ext4/Ntfs）时，才考虑预处理后缓存
canonical()结果 - 永远不要对用户输入路径无条件调用
canonical()，尤其在服务端或循环批量处理中 - 如果业务只要求“逻辑等价”（比如配置文件别名），而非“物理同一”，那应该走哈希或内容比对，而不是文件系统标识
真正难的是路径存在性、权限、符号链接策略这三者的组合判断——equivalent() 把大部分复杂度封装了，但没封装容错逻辑。你得自己决定：路径不存在时算“不同”还是“无法判断”，软链要不要展开，跨卷硬链接是否接受为“同一”。这些不是技术问题，是接口契约问题。
