c++oding="utf-8" ?>
windows下需用getfileinformationbyhandle比对dwvolumeserialnumber、ftlastwritetime及nfileindexlow/high;posix系统用stat比较st_dev与st_ino;跨平台不可依赖std::filesystem::equivalent。

Windows下用GetFileInformationByHandle比较文件标识
在Windows上,仅靠字符串相等或std::filesystem::canonical无法可靠判断两个路径是否指向同一物理文件——符号链接、硬链接、卷挂载点、UNC重定向都会让路径不同但文件相同。最稳妥的方式是打开两个路径对应的句柄,再用GetFileInformationByHandle获取dwVolumeSerialNumber和ftLastWriteTime+nFileIndexLow/nFileIndexHigh组成的唯一标识。注意:必须用GENERIC_READ(或0)+FILE_SHARE_READ | FILE_SHARE_WRITE | FILE_SHARE_DELETE打开,否则对只读/锁定文件会失败。
常见错误包括:OpenFile或CreateFileW传错dwDesiredAccess导致ERROR_ACCESS_DENIED;忽略ftLastWriteTime直接比nFileIndexLow/High(NTFS中索引号可能复用);没检查GetFileInformationByHandle返回值是否为FALSE(句柄无效时会静默失败)。
- 使用
CreateFileW时,路径必须是绝对路径且已存在,相对路径需先std::filesystem::absolute -
dwVolumeSerialNumber相同是前提,否则直接判不同;两者都相等才认为是同一文件 - 若任一路径无法打开(如权限不足、不存在),应明确返回
false而非抛异常
Linux/macOS用stat比st_dev和st_ino
POSIX系统靠stat()获取st_dev(设备ID)和st_ino(inode号)联合判定。只要这两个字段完全一致,就代表同一文件。注意stat不跟随符号链接,而lstat会——如果需求是“逻辑上同一文件”,用stat;如果是“字面路径指向同一inode”,用lstat。
容易踩的坑:stat对不存在路径返回-1并设errno,但errno可能被后续调用覆盖,必须立即检查;某些网络文件系统(如NFSv3)可能不保证st_ino全局唯一,此时需结合st_mtime+st_size辅助判断(但非100%可靠);std::filesystem::status底层调用stat,但不暴露st_dev/st_ino,必须手写stat调用。
- 路径需先转换为
std::filesystem::path再调用c_str()传给stat,避免宽字符问题 - 比较时用
==直接比st_dev和st_ino字段,不要用memcmp——结构体可能有填充字节 - 若一个路径
stat成功、另一个失败(如ENOENT),直接返回false
C++跨平台封装要注意的边界情况
没有标准库函数能直接跨平台完成该任务。std::filesystem::equivalent看似合适,但它在Windows上依赖GetFileInformationByHandle,在POSIX上用stat,看似完美——但实际有严重缺陷:它对符号链接默认不展开(即equivalent("a.txt", "link_to_a.txt")返回false),且无法控制是否跟随;更糟的是,某些旧版libstdc++(GCC equivalent存在竞态条件或缓存bug,可能返回错误结果。
因此生产环境不建议直接依赖std::filesystem::equivalent。若坚持跨平台,需自己封装:Windows走GetFileInformationByHandle路径,POSIX走stat路径,并统一处理错误码。关键点在于——所有路径必须先std::filesystem::absolute且std::filesystem::exists为真,否则equivalent可能抛std::filesystem::filesystem_error,而底层API返回更明确的错误类型。
- 绝对化路径时,
std::filesystem::absolute对空路径或非法路径会抛异常,需提前过滤 - Windows上要处理
\?前缀:若原路径已是长路径格式,absolute可能破坏其格式,建议先检测并跳过标准化 - POSIX下
stat对/proc/self/fd/N这类伪路径可能返回意外结果,需排除非常规路径模式
硬链接与符号链接的语义差异必须明确
硬链接和符号链接在文件系统层面完全不同:硬链接共享同一inode(st_ino相同),符号链接是独立文件(inode不同),只是内容指向另一路径。所以用stat比较时,两个硬链接路径必然等价;但两个符号链接即使指向同一目标,它们自身也不等价——除非你显式readlink后递归解析到最终目标再比。
这意味着“是否同一物理文件”这个问题本身就有歧义:用户真正想要的是“内容是否不可区分”,还是“存储位置是否唯一”?前者需递归解析符号链接并比最终目标;后者只需比原始路径的inode或句柄信息。多数场景(如去重、锁文件)需要后者;少数场景(如构建缓存键)需要前者。
- 若需支持符号链接递归等价,Windows用
CreateFileW配FILE_FLAG_OPEN_REPARSE_POINT+DeviceIoControl查FSCTL_GET_REPARSE_POINT,POSIX用readlink循环直到ENAMETOOLONG或非链接 - 递归深度必须限制(如16层),防止环形链接导致死循环
- 权限不足时
readlink返回-1,此时应按“不可达”处理,而非假设不等价
exists和absolute,也不要依赖equivalent的黑盒行为。C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!











