std::filesystem::copy 默认不递归复制子目录，需显式指定 recursive 选项；组合 copy_options 时须避免互斥项冲突，推荐 recursive | overwrite_existing 或 recursive | skip_existing；windows 下不保留 acl 和符号链接需额外处理。
std::filesystem::copy 为什么复制不了子目录
默认行为只复制文件，不递归——这是最常踩的坑。你调用 std::filesystem::copy(src, dst) 却发现子目录全丢了，不是 bug，是设计如此：它默认用的是 std::filesystem::copy_options::none，等价于“只拷单个文件，路径不存在就报错”。
必须显式传入递归选项才能进子目录：
-
std::filesystem::copy_options::recursive：必备，否则连一级子目录都不进 -
std::filesystem::copy_options::skip_existing或overwrite_existing：避免目标已存在时抛filesystem_error - 如果目标目录不存在，需提前创建（
create_directories(dst)），copy不会自动建父路径
copy_options 组合怎么选才安全
枚举值不是随便 or 的，顺序和冲突有讲究。比如 skip_existing 和 overwrite_existing 互斥，同时传会导致未定义行为；而 recursive 必须和其他选项用 | 拼接，不能单独用。
推荐组合（兼顾健壮与可控）：
- 全新覆盖：
std::filesystem::copy_options::recursive | std::filesystem::copy_options::overwrite_existing - 增量同步（跳过已有）：
std::filesystem::copy_options::recursive | std::filesystem::copy_options::skip_existing - 强制重试（删再拷）：先
remove_all(dst)，再用recursive | overwrite_existing
注意：update_existing 只比目标旧才覆盖，但不会处理目录时间戳逻辑，实际中很少用，容易误判。
Windows 下权限/符号链接出问题怎么办
Windows 默认不保留 ACL 权限，也不复制符号链接（symlink）本身，而是复制它指向的内容——这在跨项目部署或备份时可能破坏结构。
要控制这类行为，得加额外选项：
-
std::filesystem::copy_options::copy_symlinks：复制 symlink 文件本身（而非目标） -
std::filesystem::copy_options::skip_permission_denied：遇到权限不足（如系统文件）时不抛异常，跳过 - 真要保留 Windows ACL，得用 WinAPI（
CopyFileEx+COPY_FILE_COPY_SYMLINK等），std::filesystem::copy不支持
另外，目标路径长度超 MAX_PATH（260 字符）时，即使加了 \? 前缀，std::filesystem 在部分标准库实现（如旧版 MSVC）里仍可能失败——建议编译时开 /Zc:__cplusplus 并确认 STL 版本 ≥ VS 2019 16.10。
性能差得明显？可能是没关 last_write_time 同步
每次复制文件，std::filesystem::copy 默认会调用 last_write_time 设置目标时间戳，频繁小文件场景下，这会触发大量系统调用，拖慢 2–5 倍。
如果你不需要精确时间戳（比如只是临时打包、CI 构建缓存），可以绕过：
- 手动用
copy_file+create_directories+ 循环遍历recursive_directory_iterator - 或者复制完再批量修正时间（用
last_write_time(dst, last_write_time(src))批量设一次）
没有“禁用时间戳”的 copy_option，这是标准库当前的硬限制——别指望加个 flag 就变快，得自己拆解流程。
递归深度大、文件多时，recursive_directory_iterator 的构造本身就有开销，别在循环里反复 new 它；一次性遍历 + 预分配 vector 存路径，比边走边拷更稳。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
