复制目录树需显式指定std::filesystem::copy_options::recursive，否则抛异常；目标存在时推荐先remove_all再复制；Windows需注意路径、权限及进程占用问题；编译须启用C++17并链接对应文件系统库。
复制目录树前必须检查 std::filesystem::copy 的第三个参数
直接调用 std::filesystem::copy(src, dst) 默认行为是“只复制文件”，遇到目录会抛出 std::filesystem::filesystem_error，错误信息类似 "Operation not permitted"（实际是 permission denied 或 invalid argument）。根本原因在于默认 std::filesystem::copy_options::none 不允许递归处理子目录。
正确做法是显式传入 std::filesystem::copy_options::recursive：
std::filesystem::copy("src_dir", "dst_dir", std::filesystem::copy_options::recursive);但注意：这仍可能失败——如果 dst_dir 已存在且非空，copy 会尝试把源目录内容“合并”进去，导致 directory_iterator 冲突或权限问题。所以更稳妥的流程是先清空或确保目标不存在。
目标路径存在时的三种典型处理策略
实际项目中几乎总会遇到目标目录已存在的情况，std::filesystem::copy 不自动覆盖也不自动跳过，必须自己决策：
立即学习“C++免费学习笔记（深入）”；
- 想完全覆盖：先
std::filesystem::remove_all("dst_dir")，再copy(..., recursive) - 想增量同步（仅更新/新增文件）：需手动遍历
src_dir，对每个std::filesystem::path判断exists(dst / rel_path)和last_write_time()，再决定是否复制 - 想跳过已存在目录：加
| std::filesystem::copy_options::skip_existing，但该选项仅对**同名文件**生效，对子目录无效（C++17 标准如此），容易误判
推荐第一种——简单、可预测、符合“复制整个目录树”的原始意图。若需增量逻辑，别硬塞进 copy，改用 std::filesystem::recursive_directory_iterator 手动控制。
Windows 下路径分隔符和权限问题最常踩坑
在 Windows 上，std::filesystem::path 虽然内部能处理正斜杠，但某些旧版 MSVC（如 VS2017 Update 8 前）对 UNC 路径或含空格的路径解析不稳定；另外，目标目录若被资源管理器打开、或某文件被其他进程占用，copy 会直接抛异常，不会跳过。
实操建议：
- 统一用
std::filesystem::path构造路径，避免字符串拼接：std::filesystem::path src = "C:\data"; src /= "subdir"; - 捕获异常并检查具体错误码：
catch (const std::filesystem::filesystem_error& e) { if (e.code().value() == ERROR_ACCESS_DENIED) { /* handle */ } } - 不要依赖
std::filesystem::copy_options::overwrite_existing来绕过只读属性——它不修改文件属性，需提前调用std::filesystem::permissions(path, std::filesystem::perms::owner_write)
编译时必须确认标准库支持且启用 C++17
不是所有环境默认启用 std::filesystem。GCC 9+、Clang 7+、MSVC 2017 15.7+ 支持，但 GCC 需链接 -lstdc++fs，Clang 可能需 -lc++fs，MSVC 则无需额外链接。
关键检查点：
- 编译命令明确指定
-std=c++17（GCC/Clang）或/std:c++17（MSVC） - 包含头文件：
#include <filesystem>，而非<experimental/filesystem>（后者已弃用） - 命名空间使用
std::filesystem，不是std::experimental::filesystem
若链接时报 undefined reference to 'std::filesystem::copy'，八成是忘了加 -lstdc++fs —— 这个库在 GCC 中是独立的，不随 libstdc++ 主体加载。
真正麻烦的从来不是 API 调用本身，而是跨平台路径合法性校验、目标端残留状态清理、以及静默失败（比如权限不足但没 catch）。写一次复制逻辑，至少要在 Windows 和 Linux 上各跑三遍不同权限组合的测试。
