c++中如何使用filesystem删除目录_c++递归删除文件夹方法【实例】_技术教程

std::filesystem::remove_all是最直接的递归删除方式，用于C++17及以上标准，可删除指定路径
及其所有子项，成功返回true，失败抛出filesystem_error异常。

std::filesystem::remove_all 是最直接的递归删除方式

在 C++17 及以上标准中，std::filesystem::remove_all 是专为递归删除目录设计的标准函数。它会尝试删除指定路径及其所有子项（文件、子目录、符号链接目标等），成功时返回 true，失败时抛出 std::filesystem::filesystem_error 异常。

常见错误现象包括：程序静默失败（没捕获异常）、权限不足报错 Permission denied、路径不存在却未检查返回值、误删非空只读目录时卡住。

必须包含头文件：#include ，并链接 -lstdc++fs（GCC 早期版本需显式链接）
命名空间需启用：namespace fs = std::filesystem; 或直接用全名
路径参数支持 std::string、const char*、fs::path；推荐统一用 fs::path 避免隐式转换歧义
不自动处理“正在被其他进程占用”的文件——此时抛出异常，需手动处理重试或跳过逻辑

namespace fs = std::filesystem;
try {
    bool result = fs::remove_all("/tmp/my_temp_dir");
    if (result) {
        std::cout << "Directory removed.\n";
    } else {
        std::cout << "Path did not exist or was not a directory.\n";
    }
} catch (const fs::filesystem_error& ex) {
    std::cerr << "Remove failed: " << ex.what() << "\n";
}

手动遍历删除适合需要精细控制的场景

当你要跳过特定文件、记录删除日志、实现“安全删除”（如清空内容但保留空目录）、或兼容 C++14 环境时，需手动遍历。核心是使用 fs::recursive_directory_iterator 逆序遍历（从叶子节点向上删），避免先删父目录导致子项无法访问。

注意：正向遍历 + 直接删除会导致迭代器失效或抛出 filesystem_error（“No such file or directory”）；Windows 下对只读文件夹内文件也常失败。

务必用 fs::directory_options::skip_permission_denied 避免因权限问题中断整个遍历
删除前建议调用 fs::status(p).type() 判断是文件还是目录，再分别调用 fs::remove 或 fs::remove_all
对每个 fs::path 执行操作前，检查 fs::exists(p) —— 迭代器可能返回已失效的条目（尤其在并发修改时）

namespace fs = std::filesystem;
void safe_remove_recursive(const fs::path& p) {
    try {
        for (auto it = fs::recursive_directory_iterator(p, fs::directory_options::skip_permission_denied);
             it != fs::recursive_directory_iterator(); ) {
            auto current = it->path();
            ++it; // 提前递增，防止删除后迭代器失效
            if (fs::is_regular_file(current)) {
                fs::remove(current);
            } else if (fs::is_directory(current)) {
                fs::remove(current); // 空目录才成功；非空则失败，但后续会由父级 remove_all 处理
            }
        }
        fs::remove(p); // 最后删根目录
    } catch (const fs::filesystem_error& ex) {
        std::cerr << "Manual removal error at " << p << ": " << ex.what() << "\n";
    }
}

删除失败时的典型错误信息与应对

实际运行中，remove_all 抛出的异常消息里关键字段藏在 ex.code().message() 中，不是 ex.what() 全是人话。比如：

No such file or directory：路径根本不存在，可忽略或提前 if (!fs::exists(p)) return;
Permission denied：Linux/macOS 下文件/目录无写权限，Windows 下文件被标记为只读；解决方法是先调用 fs::permissions(p, fs::perms::owner_write, fs::perm_options::add)
Device or resource busy：目录下有进程正在使用的文件（如打开的 log 文件、挂载点）；只能终止相关进程或跳过
Directory not empty：罕见，通常说明底层文件系统异常或权限策略限制（如某些容器环境）

不要依赖异常类型做分支判断——所有错误都走 filesystem_error，靠 ex.code().value() 区分系统错误码更可靠（如 EPERM、EACCES）。

跨平台行为差异与编译注意事项

Windows 和 POSIX 系统对“删除非空只读目录”的处理不同：Windows 要求目录本身可写才能开始递归删除；Linux 只要求父目录可写。这会导致同一段代码在 Windows 上抛 Permission denied，Linux 上成功。

MSVC 19.20+ 默认启用 C++17 filesystem；GCC 8+ 支持但需加 -lstdc++fs；Clang 需确认 libstdc++ 或 libc++ 版本是否完整实现
macOS 10.15+ 的 libc++ 对 remove_all 有已知 bug（偶发不删空子目录），建议升级到 macOS 11+ 或改用手动遍历
若目标环境不支持 C++17，不要用宏开关模拟—— 已废弃，且 ABI 不兼容

真正麻烦的从来不是“怎么删”，而是“删一半失败后如何回滚”。标准库不提供事务性删除，业务层若需强一致性，得自己维护待删列表并实现反向恢复逻辑。