std::filesystem::recursive_directory_iterator默认跳过符号链接，需显式传入follow_directory_symlink选项才能遍历其目标；遍历中修改目录结构易致异常；跳过特定子目录需用disable_recursion_pending()；Windows长路径需manifest和编译配置支持。
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。
- 安全做法：只读遍历；如需边遍历边清理，请先收集所有路径到
std::vector<:filesystem::path></:filesystem::path>，再统一处理 - 避免在循环体中直接调用
std::filesystem::remove_all(it->path())—— 这大概率导致迭代器内部状态错乱 - 某些 libc++ 实现（如 macOS）对并发修改更敏感，即使只是另一个进程删了文件，也可能触发异常
如何跳过特定子目录（如 .git、build）
标准库没提供内置过滤回调，必须手动判断 it->path().filename() 或完整路径。注意：不能仅靠文件名跳过，因为 build/ 可能在任意深度出现；也不能在进入前预判——迭代器本身不支持“跳过整棵子树”，只能靠 disable_recursion_pending() 实现。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
立即学习“C++免费学习笔记（深入）”；
- 关键操作：当检测到需跳过的目录时，调用
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）。这点不踩坑，前面全白忙。
