FindFirstFileEx是最接近资源管理器搜索行为的方案，支持跳过系统保护目录、尊重索引、通配符匹配且默认不递归；需用FindExSearchNameMatch和FindExInfoBasic，手动过滤隐藏/系统属性，安全拼接路径，控制递归深度并静默处理ACCESS_DENIED。
Windows API FindFirstFileEx 是最接近资源管理器搜索行为的方案
资源管理器的“按名搜索”不是简单遍历目录，它会跳过系统保护目录、尊重文件索引状态、支持通配符（* 和 ?），且默认不递归——这些行为 FindFirstFileEx 都能对齐。用 std::filesystem::recursive_directory_iterator 反而容易误入 $Recycle.Bin 或 System Volume Information，触发权限拒绝或卡顿。
- 必须传入
FindExSearchNameMatch作为dwSearchOp参数，否则通配符无效 - 推荐搭配
FindExInfoBasic（而非FindExInfoStandard），避免额外读取文件属性，速度提升明显 - 跳过隐藏/系统目录需手动检查
dwFileAttributes中的FILE_ATTRIBUTE_HIDDEN和FILE_ATTRIBUTE_SYSTEM - 示例片段：
HANDLE h = FindFirstFileEx(L"C:\test\*.txt", FindExInfoBasic, &ffd, FindExSearchNameMatch, nullptr, 0);
递归搜索时务必控制深度并跳过权限异常路径
资源管理器实际搜索默认只进 1–2 层子目录（除非用户显式点开“搜索子文件夹”），且遇到 ACCESS_DENIED 会静默跳过，不会中断整个流程。C++ 里若用 FindNextFile 链式调用，没处理好错误码会导致崩溃或死循环。
- 每次
FindFirstFileEx后检查返回值是否为INVALID_HANDLE_VALUE，再调用GetLastError() - 若错误码是
ERROR_ACCESS_DENIED，直接FindClose并继续下一级，不要抛异常 - 用计数器限制递归深度（例如最大 3 层），避免在
OneDrive或符号链接环中无限深入 - 不要依赖
std::filesystem::is_directory前置判断——它本身可能触发权限检查，反而多一次失败
PathIsRelative 和 PathCombine 处理路径拼接比手写 + 安全得多
用户输入的搜索路径可能是相对路径（如 "Documents*.cpp"），也可能是带盘符的绝对路径（"D:code*.h"）。手拼字符串容易漏掉分隔符、重复反斜杠，或在 UNC 路径（"\servershare"）下彻底失效。
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 用
PathIsRelative判断输入是否需要补当前目录前缀 - 一律用
PathCombine拼接目录与通配符部分，它自动处理末尾反斜杠缺失问题 - 通配符模式（如
"*.log"）必须作为最后一段传入，不能塞进中间路径 - 示例：
TCHAR szFull[MAX_PATH]; PathCombine(szFull, L"C:\temp", L"*.tmp"); // 正确<br>TCHAR szBad[MAX_PATH]; wcscpy_s(szBad, L"C:\temp\*.tmp"); // 错误：没校验路径合法性
搜索结果排序和去重需在内存层完成，别指望 API 返回有序数据
资源管理器显示结果按名称升序排列，且同一个文件不会因硬链接或符号链接重复出现。但 FindFirstFileEx 返回顺序完全取决于 NTFS 目录项物理排列，既无序也不去重。
立即学习“C++免费学习笔记（深入）”；
- 把所有匹配到的
cFileName收集进std::vector<:wstring></:wstring>，最后调用std::sort - 若需排除硬链接重复，得调用
GetFileInformationByHandle比较dwVolumeSerialNumber+nFileIndexLow/High，而不是仅比对路径字符串 - 注意：
cFileName是短文件名（8.3 格式）和长文件名混合的，必须用WIN32_FIND_DATAW的宽字符字段，别用 ANSI 版本 - 排序前先转小写比较（
_wcsicmp），否则"A.txt"会排在"b.txt"后面
