要实现完整克隆，必须同时使用 std::filesystem::copy_options::recursive 和 overwrite_existing；否则会残留旧文件或遗漏子目录，且默认不校验哈希、不处理权限与符号链接。
用 std::filesystem::copy 做完整克隆，但得关掉默认的“只复制新文件”逻辑
默认调用 std::filesystem::copy 时，它不会覆盖已存在的同名文件——哪怕源文件更新了。这不是同步，是“懒拷贝”。要克隆（即完全一致），必须显式传入 std::filesystem::copy_options::overwrite_existing 和 std::filesystem::copy_options::recursive。
- 漏掉
overwrite_existing：目标里旧文件残留，目录看起来“同步了”，实际内容陈旧 - 漏掉
recursive：只复制顶层，子目录全丢，克隆失败 - 顺序很重要：两个 flag 要一起用，单独用
overwrite_existing对目录无效
示例关键行：
std::filesystem::copy(src, dst, std::filesystem::copy_options::recursive | std::filesystem::copy_options::overwrite_existing);
std::filesystem::copy 同步前不校验时间戳或哈希，靠的是“存在性+修改时间”
C++17 的 std::filesystem::copy 不读文件内容，判断是否跳过复制，只比对 last_write_time()。这意味着：
- 如果源文件被重写但修改时间没变（比如某些编辑器保存策略、NFS 挂载、容器内文件系统），同步会跳过，目标不更新
- 如果目标文件被手动改过但时间戳更新了，会被误覆盖
- 没有内置的哈希校验或大小+时间双判逻辑，没法规避时钟不同步或精度丢失问题
真要强一致性，得自己加一层 file_size() 比较，或者在关键路径上 fallback 到 std::filesystem::equivalent() + 内容比对（但后者开销大，慎用）。
立即学习“C++免费学习笔记（深入）”；
Windows 下路径分隔符和权限继承容易出错
虽然 std::filesystem 自动处理正斜杠/反斜杠，但 Windows 上复制后目标文件可能丢失执行权限或 ACL 继承标记，尤其涉及符号链接或管理员创建的目录时：
-
std::filesystem::copy默认不复制所有权、ACL、备用数据流（ADS） - 普通用户调用时，若源目录含 SYSTEM 或 TrustedInstaller 权限项，目标可能创建失败并抛
std::filesystem::filesystem_error - 符号链接默认被“解引用”复制（即复制目标文件），不是复制链接本身；要保留链接，得加
std::filesystem::copy_options::copy_symlinks
常见报错：Permission denied 或 Operation not permitted，不是代码写错了，是权限上下文不足。
增量同步不能只靠 copy，得手动遍历+决策
std::filesystem::copy 是“全量覆盖”工具，不是 rsync 风格的增量同步器。要做真正的同步（比如只更新变更文件、删除目标多余项），必须自己走一遍源目录树，再对比目标状态：
- 遍历源目录，对每个
std::filesystem::directory_entry，检查目标对应路径是否存在、是否为目录/文件、last_write_time()是否旧于源 - 目标有而源没有的条目，需额外收集后统一删除（避免边遍历边删导致迭代器失效）
- 跨文件系统移动时，
std::filesystem::copy可能退化为“读+写”，性能骤降，此时应检测std::filesystem::is_same_file_system()
最易被忽略的一点：同步不是“从 A 复制到 B”，而是“让 B 等价于 A”——这天然包含删除操作，而标准库没提供 sync_directory 这样的原子接口。
