应使用std::filesystem::recursive_directory_iterator替代directory_iterator实现递归遍历，它原生支持深度优先遍历、自动跳过符号链接循环，并可通过disable_recursion_pending()控制分支，避免手动递归的栈溢出与死循环风险。
用 std::filesystem::recursive_directory_iterator 替代 directory_iterator
直接遍历子目录？std::filesystem::directory_iterator 不递归，它只扫一层。硬写循环套循环容易漏 symlink、跳过异常路径，还重复处理 operator++ 异常。该换 recursive_directory_iterator —— 它原生支持深度优先遍历，自动跳过循环符号链接（默认行为），且能响应 disable_recursion_pending() 手动控制分支。
常见错误现象：directory_iterator 遇到子目录就停住，或手动调用 is_directory() 后再构造新迭代器，结果抛 filesystem_error（权限不足/路径失效）却没捕获，整个遍历中断。
- 必须包含
<filesystem>，C++17 起可用，MSVC 19.20+、GCC 8.1+、Clang 7.0+ 支持 - 编译需显式链接 stdc++fs（GCC/Clang）：加
-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更高效
示例片段：
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
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 循环 + 手动 push/pop 目录栈，逻辑看似可控，实则埋雷：递归深度大时栈易爆；遇到 symlink 循环（A→B→A）会无限遍历；directory_iterator 构造失败时没有“跳过”选项，必须 catch 异常并手动 pop，代码臃肿且易漏。
真正省事又健壮的方式，就是接受 recursive_directory_iterator 的设计约束：它内部已用栈模拟递归，支持 disable_recursion_pending() 剪枝，异常策略统一。你只需要决定“进哪个门”，不用操心“怎么下楼”。
容易被忽略的一点：它的默认构造是 end 迭代器，且不可赋值为其他迭代器（C++20 前），所以初始化必须带路径和选项，不能先声明再赋值。
