是，std::filesystem::equivalent 会将硬链接判为等价，因其底层比较 inode（linux/macos）或文件 id（windows），而硬链接共享同一文件实体；但要求两路径均存在、可访问且位于同一文件系统，否则抛 filesystem_error。
std::filesystem::equivalent 会把硬链接判为等价吗？
会，但仅限于支持硬链接的文件系统（如 ext4、NTFS），且要求两个路径都指向同一 inode（Linux/macOS）或文件 ID（Windows）。std::filesystem::equivalent 的语义就是“是否代表同一文件实体”，硬链接天然满足该条件——它和原文件共享底层存储对象。
不过要注意：符号链接（symlink）默认不被判定为等价，除非你先用 std::filesystem::canonical 展开；而软链接指向不同 inode，即使内容相同也不会返回 true。
- Linux/macOS 上，只要两个路径是同一文件的硬链接，
equivalent(a, b)返回true - Windows 上需启用开发者模式或使用 NTFS 卷，且硬链接必须由
fsutil hardlink或 API 创建，普通资源管理器操作不产生硬链接 - 如果任一路径不存在、无权限访问或跨文件系统（比如一个在 /tmp，一个在 /home），
equivalent抛出std::filesystem::filesystem_error
跨平台调用 equivalent 时必须处理哪些异常？
不能假设 equivalent 总是静默返回 bool。它可能因权限、路径无效或跨设备失败而抛异常，尤其在 CI 环境或容器中常见。
典型错误信息包括："Operation not permitted"（Linux 容器无 CAP_DAC_OVERRIDE）、"Access is denied"（Windows 权限不足）、"Invalid argument"（路径含非法字符或为空）。
- 始终用
try/catch包裹，捕获std::filesystem::filesystem_error，不要只靠exists()预检——预检通过不代表equivalent能成功执行 - 避免在循环里频繁调用；若需批量判断，优先用
std::filesystem::status拿到file_status后比对st_ino和st_dev（POSIX）或FILE_ID_INFO（Windows），但这是非标准做法，失去可移植性 - 注意 C++17 标准规定：若任一路径为 relative path，行为依赖当前工作目录——建议统一转成
absolute再比较
为什么在 macOS 上有时 equivalent 返回 false？
macOS 默认文件系统 APFS 对硬链接支持有限：它只允许在同一个 APFS 分区（volume）内创建硬链接，且仅对空文件或特定权限设置下的文件生效；更重要的是，APFS 的硬链接实现与传统 Unix 不同，某些场景下 stat() 返回的 st_ino 可能不唯一，导致 equivalent 底层判定失败。
- 确认两个路径确实在同一 APFS volume（用
df -T检查） - 用
ls -i查看 inode 是否一致；如果不一致，说明不是真正硬链接，可能是 clone 文件或 APFS snapshot 副本 - macOS 上更可靠的同源性判断方式是结合
std::filesystem::read_symlink（排除 symlink）+std::filesystem::status获取file_size和最后修改时间 + 内容哈希（小文件可直接读取比对）
equivalent 和手动生成 inode+dev 对比有何实际差异？
直接读 stat.st_ino 和 stat.st_dev 看似更底层、更快，但它绕过了 std::filesystem 的抽象层，带来三类风险：
- Windows 上没有
st_ino，得调用GetFileInformationByHandle提取dwVolumeSerialNumber和nFileIndexHigh/Low，代码量翻倍且易出错 - 某些文件系统（如 NFS、FUSE 实现）可能返回伪造或不稳定 inode，
equivalent内部做了适配，而裸 stat 可能误判 -
equivalent自动处理符号链接解析策略（默认不跟随 symlink），而手动 stat 需显式控制statvslstat，容易混淆
除非性能压测证明 equivalent 成为瓶颈（通常不会），否则坚持用标准接口。它的跨平台一致性价值远高于微秒级开销。
硬链接同源性判断真正麻烦的从来不是函数调用本身，而是路径有效性、权限上下文、文件系统能力边界这三层现实约束——写完 equivalent 调用后，记得检查这些地方，而不是盯着返回值反复调试。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
