C++如何遍历filesystem::directory_iterator _ 文件夹递归查找【实战】

C++文件系统遍历：从手动递归到标准库的优雅升级

在文件系统操作中，递归遍历目录是个高频需求。过去，开发者常常手动实现递归逻辑，但其中暗藏的陷阱可不少。比如，直接使用 std::filesystem::directory_iterator 并手动循环嵌套，不仅代码冗长，还容易在处理符号链接、权限异常时翻车。一个更优雅、更健壮的方案是使用标准库提供的专用工具。

应使用std::filesystem::recursive_directory_iterator替代directory_iterator实现递归遍历，它原生支持深度优先遍历、自动跳过符号链接循环，并可通过disable_recursion_pending()控制分支，避免手动递归的栈溢出与死循环风险。

用 std::filesystem::recursive_directory_iterator 替代 directory_iterator

想直接遍历子目录及其所有内容？std::filesystem::directory_iterator 可做不到这一点，它只扫描当前目录这一层。如果硬着头皮写循环套循环，很容易遗漏对符号链接的处理、跳过异常路径，还会重复面对 operator++ 可能抛出的异常。这时候，就该换上 recursive_directory_iterator 了。它原生就支持深度优先遍历，能自动跳过会造成循环的符号链接（这是默认行为），并且允许你通过 disable_recursion_pending() 来手动控制是否进入某个分支。

一个常见的错误现象是：使用 directory_iterator 时，遇到子目录就停住了；或者手动调用 is_directory() 判断后，再构造一个新的迭代器去遍历子目录，结果因为权限不足或路径失效而抛出 filesystem_error，如果没有妥善捕获，整个遍历过程就会意外中断。

• 头文件与标准：必须包含 头文件，该功能从 C++17 起可用。主流编译器如 MSVC 19.20+、GCC 8.1+、Clang 7.0+ 均已支持。
• 编译链接：在 GCC 或 Clang 下编译时，需要显式链接 stdc++fs 库，即添加 -lstdc++fs 编译选项；MSVC 则默认已启用，无需额外操作。
• 异常处理：构造迭代器时，可以传入 std::filesystem::directory_options::skip_permission_denied 选项。这能让迭代器静默跳过那些无权访问的目录，从而避免因权限异常导致遍历中断。

遍历时如何安全过滤文件与目录

在遍历过程中筛选目标文件时，可别单纯依赖 path.extension() == “.txt” 这样的判断。文件扩展名可能为空、可能包含多个点（比如 archive.tar.gz），甚至目标可能根本就不是一个普通文件。更稳妥的做法是，先用 is_regular_file() 或 is_directory() 确认条目类型，再进行后续的内容操作。

一个典型的使用场景是：查找所有 .log 日志文件，但同时要排除像 tmp/ 或 node_modules/ 这样的临时或缓存目录。

立即学习“C++免费学习笔记（深入）”；

• 文件名匹配：使用 iter->path().filename().string() 来获取文件名并进行字符串匹配，这比用 stem() 更稳妥，因为 stem() 会去掉最后一个点之后的所有内容。
• 目录排除：检查当前条目是否为需要跳过的目录时，使用 iter->path().filename() == “node_modules” 来比较文件名，而不是比较完整路径。因为在递归过程中，完整路径会不断变化。
• 递归控制：在进入某个特定目录之前，调用 iter.disable_recursion_pending() 可以阻止迭代器继续遍历该目录下的子项。这比进入目录后再用 continue 跳过其子项要高效得多。

下面是一个示例代码片段：

for (auto iter = fs::recursive_directory_iterator(root, opts); iter != fs::recursive_directory_iterator(); ++iter) {
    const auto& p = iter->path();
    if (p.filename() == “build” || p.filename() == “__pycache__”) {
        iter.disable_recursion_pending();
        continue;
    }
    if (fs::is_regular_file(p) && p.extension() == “.log”) {
        found_logs.push_back(p);
    }
}

处理权限错误和损坏符号链接

现实世界的文件系统充满“意外”：Linux 下可能遇到无读权限的目录，macOS 上可能碰到挂载失败的网络卷，Windows 中可能闯入被占用的文件夹——这些情况都会导致 recursive_directory_iterator 在构造或自增时抛出 std::filesystem::filesystem_error。如果不做捕获，程序就会崩溃。

从性能角度看，每次异常处理确实有一定开销，但这总比进程直接退出要好。在兼容性方面，各标准库对 skip_permission_denied 选项的实现基本一致，可以放心使用。

• 跳过无权限目录：在构造迭代器时传入 fs::directory_options::skip_permission_denied 选项，迭代器会自动跳过那些无法打开的目录，而不是抛出异常。
• 处理损坏的符号链接：仍有可能遇到损坏的符号链接（is_symlink() 返回 true，但 symlink_status() 调用失败）。此时，调用 iter->status() 可能会抛错，因此需要在循环内部使用 try/catch 块进行局部捕获。
• 状态查询选择：注意，不要用 fs::status(p) 替代 iter->status()。前者会额外发起一次系统调用，并且可能因为路径状态在两次调用间发生变化而得到不一致的结果。

为什么不能用 std::filesystem::directory_iterator 做递归

有些开发者尝试用 while 循环配合手动维护的目录栈来模拟递归，逻辑上看似可控，实则埋下了不少隐患：当递归深度很大时，手动管理的栈容易溢出；遇到符号链接循环（例如 A→B→A）会导致无限遍历；而且，directory_iterator 在构造失败时没有“跳过”的选项，必须手动捕获异常并从栈中弹出目录，代码会变得臃肿且容易遗漏错误处理。

真正省心又健壮的方式，是接受并善用 recursive_directory_iterator 的设计。它内部已经用栈模拟了递归过程，支持通过 disable_recursion_pending() 进行剪枝，并且提供了统一的异常处理策略。你的任务就变成了决定“要进入哪个目录”，而无需操心“如何一步步深入并安全返回”的底层细节。

还有一个容易被忽略的细节：recursive_directory_iterator 的默认构造函数得到的是一个 end 迭代器，并且在 C++20 之前，它不能被赋值给其他迭代器。因此，初始化时必须直接传入路径和选项，而不能先声明一个迭代器变量然后再赋值。