std::filesystem是c++17跨平台比对目录差异最轻量可靠方案，需用directory_iterator缓存元数据、统一用status()处理符号链接、分类标记缺失/变更/触碰等差异，并谨慎处理时间精度与异常。
用 std::filesystem 遍历目录并比对文件元数据
标准库从 C++17 开始提供 std::filesystem，它是跨平台比对目录差异最轻量、最可靠的选择。别用自己拼路径字符串或调系统命令——容易漏掉符号链接、权限位、时区偏移等问题。
核心逻辑是：分别遍历两个目录树，构建 std::map<:string std::filesystem::file_time_type></:string> 和 std::map<:string std::uintmax_t></:string>（路径 → 修改时间 / 大小），再按路径做交集与差集比对。
-
std::filesystem::is_regular_file()必须检查，跳过目录、socket、设备文件等非普通文件 - 路径统一用
std::filesystem::relative_path()或转为std::filesystem::canonical()后比较，避免"./a.txt"和"a.txt"被当成不同路径 - 修改时间比较要用
==（file_time_type支持直接比较），但注意 Windows FAT32 时间精度只有 2 秒，NTFS 是 100ns；Linux ext4 通常纳秒级——跨平台时慎用「严格相等」判断
处理缺失文件与同名不同内容的边界情况
仅比对存在路径不等于完成差异检测：一个目录有 a.txt，另一个没有，是「缺失」；都有但大小不同，是「内容变更」；大小相同但时间戳不同，可能是「未修改但被 touch 过」——这些需分类标记，不能一概视为“不一致”。
- 用三个集合区分：
only_in_left、only_in_right、in_both，再对in_both逐个比对file_size()和last_write_time() - 若大小相同但时间戳不同，可加一个容差（如 ±1s），用
std::abs((t1 - t2).count()) > 1'000'000'000判断是否真变更（单位是纳秒） - 遇到硬链接或重复 inode（Linux/macOS），
std::filesystem::hard_link_count()可辅助识别，但一般场景无需深挖
性能关键点：避免重复 stat、跳过不需要的子目录
对大型目录（比如含数万文件的构建输出目录），反复调 std::filesystem::file_size() 和 last_write_time() 会显著拖慢速度——每次都是系统调用。
- 用
std::filesystem::directory_iterator一次获取directory_entry，它缓存了大部分元数据；不要先取路径再单独status() - 提前过滤：用
std::filesystem::is_directory()跳过子目录（除非你要递归比对整个树），或用std::regex排除"\.git/|__pycache__/|build/"类路径 - Windows 上启用
FILE_FLAG_BACKUP_SEMANTICS（需 WinAPI）能加速，但std::filesystem不暴露该选项，所以别指望标准库自动优化
常见错误：时区、符号链接、权限导致误判
直接比对 last_write_time() 值在跨机器同步场景下极易出错——不是所有系统都把时间存为 UTC；符号链接目标文件可能被误当作普通文件；只读文件的修改时间可能被冻结。
- 不要依赖
std::filesystem::last_write_time()的绝对值，重点看相对变化；若需精确一致性校验，必须配合哈希（如 SHA-256），但那是另一层开销 - 默认情况下
std::filesystem::directory_iterator不解引用符号链接，symlink_status()和status()返回不同结果——比对前统一用status()确保拿到目标文件元数据 - 某些只读挂载或容器环境里，
last_write_time()可能返回 epoch 时间（1970-01-01）或抛std::filesystem::filesystem_error，务必用try/catch包裹
真正麻烦的从来不是怎么写循环，而是搞清「你到底要定义什么是‘差异’」：是字节级一致？还是业务上允许时间戳漂移？或是忽略临时文件？这些决策点比代码本身更影响结果可信度。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
