filesystem::copy 默认不递归复制子目录，需显式指定 fs::copy_options::recursive；若目标已存在，还需组合 overwrite_existing 才能覆盖。
filesystem::copy 会递归复制子目录吗？
默认不会。filesystem::copy 对目录只做“浅拷贝”——它把源目录建出来，但里面一个文件都不复制，除非你显式传 copy_options::recursive。
常见错误是写成：fs::copy(src, dst)，结果 dst 下只多了一个空文件夹，还以为函数坏了。
- 必须加选项：
fs::copy(src, dst, fs::copy_options::recursive) - 如果
dst已存在且是目录，recursive才会让它把src里所有内容（含嵌套）塞进去 - 如果
dst不存在，recursive也会自动创建dst目录并填充内容
目标路径已存在时 copy 报错 “File exists” 怎么办？
这是最常卡住的点：filesystem::copy 默认拒绝覆盖已有文件或目录，哪怕你加了 recursive，遇到同名文件立刻抛 filesystem_error，错误信息是 File exists。
解决方法不是删目标再拷，而是组合使用覆盖选项：
- 加
fs::copy_options::overwrite_existing：覆盖同名普通文件 - 加
fs::copy_options::skip_symlinks（可选）：避免把符号链接当真实文件处理出错 - 注意：这两个选项必须和
recursive一起用，用按位或：fs::copy_options::recursive | fs::copy_options::overwrite_existing
Windows 下权限失败或长路径报错怎么办？
C++17 filesystem 在 Windows 上默认走 Win32 API，对权限敏感、对路径长度有限制（MAX_PATH=260）。你可能看到 Operation not permitted 或 Filename too long 错误。
这不是代码逻辑问题，是平台约束：
- 确保进程有读取源目录、写入目标目录的权限（尤其在 Program Files 或用户 Profile 下操作时）
- 启用长路径支持：Windows 10 1607+ 需在组策略或注册表开启
LongPathsEnabled，否则超过 260 字符的路径直接失败 -
filesystem::copy不处理 ACL 继承，目标目录权限 = 当前进程创建时的有效 umask / 安全描述符，别指望它自动复制源目录的完整权限
想跳过某些文件（比如 .git、__pycache__）怎么过滤？
filesystem::copy 本身不提供过滤回调，不能像 Python 的 shutil.copytree(..., ignore=...) 那样直接传函数。你得手动遍历 + 条件判断。
典型做法是用 fs::recursive_directory_iterator 扫描源目录，逐个检查路径，再调用 fs::copy_file 或 fs::create_directories 构建目标结构：
for (const auto& entry : fs::recursive_directory_iterator(src)) {
fs::path rel = entry.path().lexically_relative(src);
fs::path dst_path = dst / rel;
if (rel.filename() == ".git" || rel.string().find("__pycache__") != std::string::npos) continue;
if (entry.is_regular_file()) fs::copy_file(entry, dst_path, fs::copy_options::overwrite_existing);
else if (entry.is_directory()) fs::create_directories(dst_path);
}
这个循环比单次 copy 略慢，但控制力强；漏掉 create_directories 就会导致写文件时因父目录不存在而崩溃。
真正麻烦的是符号链接、硬链接、特殊设备文件——filesystem::copy 默认不复制它们，手动处理要额外判断 is_symlink() 并调用 copy_symlink()，稍不注意就丢元数据。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
