std::filesystem::recursive_directory_iterator是C++17标准库提供的深度优先目录遍历迭代器，自动递归进入子目录，无需手动实现递归逻辑；使用时需启用C++17、捕获filesystem_error异常，并可选directory_options控制符号链接与权限错误行为。
recursive_directory_iterator 会自动递归，不需要手动遍历子目录
它不是“支持递归搜索”的工具，而是“天然按递归顺序遍历目录树”的迭代器。只要构造时传入根路径，++it 就会自动进入子目录、回退到父目录，按深度优先顺序走完整棵树。你不需要写递归函数，也不用判断 is_directory() 后再开新循环。
常见错误是把它当 std::find_if 那样用——试图“搜索某个文件名”，但 recursive_directory_iterator 本身不带查找逻辑，它只负责遍历。要搜索，得配合 std::find_if 或手写循环检查每个 path 的 filename() 或 string()。
遍历时必须捕获 filesystem_error 异常
权限不足、挂载点失效、符号链接成环等都会抛出 std::filesystem::filesystem_error。默认情况下，迭代器遇到这类错误会直接终止遍历（C++17 标准行为），且不提供跳过选项。不加 try/catch 很容易漏掉大量路径，尤其在遍历系统目录或用户家目录时。
- 必须在外层循环包 try/catch，不能只在循环体里捕获
- 捕获后可选择
continue跳过当前项，但注意：异常发生在++it过程中，不是*it访问时 - 若想跳过所有访问失败的路径，需启用
std::filesystem::directory_options::skip_permission_denied
正确做法：
for (auto it = fs::recursive_directory_iterator(root, ec); it != fs::recursive_directory_iterator(); ++it) {
if (ec) { ec.clear(); continue; }
// 处理 *it
} 或更稳妥地用异常模式 + directory_options::skip_permission_denied。
用 directory_options 控制遍历行为，避免死循环和权限崩溃
默认构造的 recursive_directory_iterator 对符号链接不做特殊处理，遇到软链指向父目录就可能无限递归。C++17 提供 directory_options 枚举来控制关键行为：
立即学习“C++免费学习笔记（深入）”；
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
-
directory_options::follow_directory_symlink：是否跟随目录软链（默认不跟） -
directory_options::skip_permission_denied：遇到无权读取的目录时静默跳过（推荐开启） - 两者可按位或组合，例如：
fs::directory_options::follow_directory_symlink | fs::directory_options::skip_permission_denied
注意：Windows 下符号链接行为与 Linux 不同，且 follow_directory_symlink 在某些旧版 MSVC 中支持不完整，建议先用 fs::is_symlink(it->symlink_status()) 显式判断再决定是否 disable_recursion_pending()。
搜索文件名时别直接比对 path::string()，小心大小写和路径分隔符
在 Windows 上，文件名比较通常应忽略大小写；Linux 则严格区分。直接用 path.filename().string() == "foo.txt" 在跨平台代码里会出错。更健壮的做法是：
- 用
path.filename().generic_string()统一为正斜杠格式（避免 Windows 反斜杠干扰） - 转小写后再比较（如用
std::tolower遍历字符串），或用std::equal配合忽略大小写的谓词 - 如果目标是通配符匹配（如
"*.log"），不要手写字符串匹配，改用path.extension() == ".log"或path.filename().stem().string()拆解
例如查找所有 .cpp 文件：
if (it->path().extension() == ".cpp") { /* found */ } 比 it->path().string().find(".cpp") != std::string::npos 更准确，不会误中 myapp.cpp.bak。
真正麻烦的是符号链接循环和跨平台大小写语义差异，这两点不提前处理，跑着跑着就卡死或漏结果。其他都是语法细节。
