C++17起推荐用std::filesystem::recursive_directory_iterator递归遍历目录树，它跨平台、简洁、默认不跟随符号链接且自动跳过循环链接和权限不足目录；需显式传directory_options::skip_permission_denied以明确行为；应先解引用再自增迭代器，用range-for更安全；文件名匹配须提取entry.path().filename()后操作，避免误匹配路径；Windows下需统一UTF-8编码并配置编译选项或转换命令行参数。
用 std::filesystem::recursive_directory_iterator 遍历目录树
这是 C++17 起最直接、跨平台的递归遍历方式，比手写 opendir/readdir 或 Win32 FindFirstFile 简洁得多，且自动处理符号链接（默认不跟随，符合安全预期）。
关键点：
-
std::filesystem::recursive_directory_iterator默认跳过循环符号链接和权限不足目录，不会崩溃但会静默跳过 —— 如果需报错，得手动捕获std::filesystem::filesystem_error - 构造时传入
std::filesystem::directory_options::skip_permission_denied可显式启用跳过行为（这是默认值，但显式写出更清晰） - 不要在循环中对迭代器做 ++ 后再解引用：错误写法
++it; auto p = *it;；正确是先解引用再自增，或用范围 for
for (const auto& entry : std::filesystem::recursive_directory_iterator(path,
std::filesystem::directory_options::skip_permission_denied)) {
if (entry.is_regular_file()) {
// 处理文件
}
}用 std::string_view::ends_with 或 std::filesystem::path::filename() 做文件名匹配
搜索目标通常是“文件名包含某字符串”或“以某后缀结尾”，别直接用 std::string::find 去查完整路径 —— 这会误中子目录名。必须提取文件名部分。
实操建议：
立即学习“C++免费学习笔记（深入）”；
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 用
entry.path().filename().string()获取纯文件名（含扩展名），再转std::string_view操作，避免重复构造 - C++20 起可用
sv.ends_with(".txt")，C++17 则用sv.compare(sv.size() - suffix.size(), suffix.size(), suffix) == 0或封装成小函数 - 忽略大小写？
std::tolower逐字符转换比std::equal+std::locale更轻量，但注意只对 ASCII 安全；若需 Unicode 支持，得用 ICU 或平台 API
处理中文路径和宽字符问题（Windows 下最常翻车）
Windows 默认使用 UTF-16 编码路径，而 std::filesystem 在 MSVC 下要求输入 std::wstring 或 UTF-8 编码的 std::string（取决于编译选项）。直接传 ANSI 字符串会导致乱码或找不到目录。
解决方案：
- 统一用 UTF-8：编译时加
/utf-8（MSVC）或-finput-charset=utf-8 -fexec-charset=utf-8（GCC/Clang），然后所有路径参数用std::string+ UTF-8 字面量 - 若用户从命令行传参，Windows 的
GetCommandLineW+WideCharToMultiByte(CP_UTF8)转换是可靠做法；Linux/macOS 命令行参数本就是 UTF-8，无需转换 - 别依赖
std::cout 调试 —— 控制台编码可能不匹配，优先用日志文件或调试器看 <code>entry.path().u8string()
性能优化：避免重复构造 std::filesystem::path 和字符串
在千级子目录、万级文件场景下，频繁调用 entry.path().filename().string() 会触发多次内存分配。热点往往不在磁盘 I/O，而在字符串操作。
可优化点：
- 用
entry.path().c_str()获取底层 C 字符串指针，配合std::string_view截取文件名（需反向找最后一个/或\） - 预编译搜索模式：如果支持通配符（如
*.log），用std::regex开销大，改用简单 glob 匹配逻辑（例如只处理*和?） - 搜索中途按 Ctrl+C 中断？注册
SIGINT信号处理器并设原子标志位，每次循环开头检查，避免强行终止导致资源未释放
真正难的不是遍历或匹配，而是让工具在中文路径、权限异常、超长文件名、符号链接环这些边界情况下不崩、不漏、不卡死 —— 这些细节没打补丁前，用户第一印象就是“不能用”。
