不会。std::filesystem::copy 默认不递归复制目录,仅创建空目标目录;需显式指定 std::filesystem::copy_options::recursive 且满足源为目录、目标不存在或也为目录等条件才能完整递归复制。

std::filesystem::copy 会自动递归复制目录吗?
不会。默认情况下 std::filesystem::copy 对目录只做“浅拷贝”——即仅创建目标目录,不复制其内容,除非显式传入 std::filesystem::copy_options::recursive。这是最容易踩的坑:代码看似正常执行,但目标目录空空如也。
正确调用 std::filesystem::copy 递归复制的必要参数
必须同时满足三个条件才能完成完整递归复制:
- 源路径是目录(
std::filesystem::is_directory(src)返回true) - 目标路径不存在,或存在但也是目录(否则抛出
std::filesystem::filesystem_error) - 显式指定
std::filesystem::copy_options::recursive,且通常还需搭配std::filesystem::copy_options::skip_symlinks或std::filesystem::copy_options::copy_symlinks明确符号链接行为
常见错误写法:std::filesystem::copy(src, dst) —— 缺少选项,等价于只调用 create_directory(dst)。
推荐写法示例:
立即学习“C++免费学习笔记(深入)”;
try {
std::filesystem::copy(
src,
dst,
std::filesystem::copy_options::recursive |
std::filesystem::copy_options::skip_symlinks
);
} catch (const std::filesystem::filesystem_error& e) {
// 注意:e.what() 可能包含 "File exists" 或 "Permission denied"
std::cerr << "Copy failed: " << e.what() << '\n';
}目标目录已存在时的行为与处理策略
当 dst 已存在且是目录时,std::filesystem::copy 默认会将 src 的**内容合并进** dst(即类似 cp -r src/* dst/),而不是覆盖整个 dst。这常被误认为“没复制成功”,其实是复制了,但文件落在了 dst/src_name/ 下。
如果你要的是“完全替换目标目录”,需先手动删除再复制:
- 用
std::filesystem::remove_all(dst)清理旧目录(注意权限和只读文件) - 确保
dst父目录可写,否则remove_all或后续copy都会失败 - 若只需覆盖同名子项(如只更新变更文件),则应避免
remove_all,改用遍历 + 条件复制逻辑
Windows 上的权限与长路径限制
在 Windows 下,std::filesystem::copy 依赖系统 API(如 CopyFileExW),会受以下限制影响:
- 路径长度超过
MAX_PATH(260 字符)时可能静默失败,需启用长路径支持(注册表或清单文件),或确保编译时定义_UNICODE和UNICODE并使用 UTF-16 路径 - 目标目录若含只读文件,
copy不会自动清除只读属性,导致失败;此时需提前用std::filesystem::permissions(path, std::filesystem::perms::owner_write)修正 - 跨卷复制(如 C:\ → D:\)在某些 Windows 版本中可能退化为“复制+删除”,而非原子移动,这点和 POSIX 行为不同
实际项目中,建议始终捕获 std::filesystem::filesystem_error 并检查 e.code().value()(如 ERROR_ACCESS_DENIED 对应 5),比单纯依赖 e.what() 更可靠。
递归复制看着简单,但路径语义、权限继承、符号链接策略、跨平台异常码这些细节,一个没对齐就卡住一上午。


















