C++如何使用std::filesystem::recursive_directory_iterator遍历目录-C++-PHP中文网

c++oding="utf-8" ?>

std::filesystem::recursive_directory_iterator默认跳过符号链接，需显式传入follow_directory_symlink选项才能遍历其目标；遍历中修改目录结构易致异常；跳过特定子目录需用disable_recursion_pending()；windows长路径需manifest和编译配置支持。

c++如何使用std::filesystem::recursive_directory_iterator遍历目录

recursive_directory_iterator 会跳过符号链接，除非显式启用

默认情况下，std::filesystem::recursive_directory_iterator 遇到符号链接（symlink）会直接跳过，不会进入，也不会报错——这容易让人误以为目录“不存在”或“为空”。如果你需要遍历符号链接指向的目标目录，必须传入 std::filesystem::directory_options::follow_directory_symlink 选项。

常见错误现象：在包含软链接的项目目录中调用迭代器后，发现某些子目录完全没被访问到，但用 ls -la 或资源管理器确认链接存在且可访问。

正确写法：std::filesystem::recursive_directory_iterator(path, std::filesystem::directory_options::follow_directory_symlink)
若同时想忽略权限不足的目录（如 /proc/12345/fd），可按位或组合：follow_directory_symlink | skip_permission_denied
注意：Windows 上符号链接行为受系统权限和创建方式影响，非管理员创建的 symlink 可能不被跟随

迭代器失效的典型场景：遍历中修改目录结构

recursive_directory_iterator 不是快照式遍历，它在每次 ++it 或 it++ 时才探测下一层内容。如果在遍历过程中删除、重命名当前正在访问的目录，或者移动某个子目录到别处，下一次递增很可能抛出 std::filesystem::filesystem_error，错误码通常是 std::errc::no_such_file_or_directory 或 std::errc::not_a_directory。

C++ Code Review Master

组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。

下载

安全做法：只读遍历；如需边遍历边清理，请先收集所有路径到 std::vector<:filesystem::path></:filesystem::path>，再统一处理
避免在循环体中直接调用 std::filesystem::remove_all(it->path()) —— 这大概率导致迭代器内部状态错乱
某些 libc++ 实现（如 macOS）对并发修改更敏感，即使只是另一个进程删了文件，也可能触发异常

如何跳过特定子目录（如 .git、build）

标准库没提供内置过滤回调，必须手动判断 it->path().filename() 或完整路径。注意：不能仅靠文件名跳过，因为 build/ 可能在任意深度出现；也不能在进入前预判——迭代器本身不支持“跳过整棵子树”，只能靠 disable_recursion_pending() 实现。

关键操作：当检测到需跳过的目录时，调用 it.disable_recursion_pending()，它会让迭代器跳过该目录下的所有后代

示例逻辑：

for (auto it = fs::recursive_directory_iterator(root); it != fs::recursive_directory_iterator(); ++it) {
    if (it->is_directory() && (it->path().filename() == ".git" || it->path().filename() == "build")) {
        it.disable_recursion_pending();
        continue;
    }
    // 处理文件...
}

注意：必须在 it 指向该目录时立即调用 disable_recursion_pending()；等走到其子项再处理就晚了

Windows 路径长度和长文件名支持必须开启

在 Windows 上，如果路径超过 260 字符（如嵌套很深的 node_modules），即使启用了 long path 支持，recursive_directory_iterator 仍可能在构造时就抛出 std::filesystem::filesystem_error，错误信息类似 The system cannot find the path specified。

前置条件：确保程序 manifest 中声明了 longPathAware=true，且系统组策略“启用 Win32 长路径”已打开（Win10 1607+）
编译时链接选项：MSVC 需加 /D_WIN32_WINNT=0x0A00（对应 Win10），否则 std::filesystem 内部仍走旧 API
一个易忽略点：CMake 项目中若用 set(CMAKE_CXX_STANDARD 17) 但未设 set(CMAKE_CXX_STANDARD_REQUIRED ON)，某些旧工具链可能降级为 C++14，导致 std::filesystem 不可用

最麻烦的其实是跨平台路径拼接和编码——std::filesystem::path 在 Windows 用反斜杠、Linux 用正斜杠，但 operator/ 会自动适配；真正容易崩的是把 path.string() 当作 UTF-8 传给 Qt 或 Python C API，而 Windows 默认返回本地 ANSI 编码（如 GBK）。这点不踩坑，前面全白忙。

C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！