推荐使用C++17 std::filesystem遍历搜索文件，需启用C++17标准、包含头文件，用recursive_directory_iterator配合skip_permission_denied选项，并检查is_regular_file()和filename()匹配目标名。
用 std::filesystem 遍历目录搜索文件（C++17 起）
现代 C++ 推荐直接用标准库的 std::filesystem，无需第三方依赖，跨平台支持良好（GCC 8+、Clang 7+、MSVC 2017 Update 5+）。它能自然处理路径拼接、符号链接跳转和异常边界。
常见错误是忽略 std::filesystem::directory_iterator 对符号链接的默认行为（可能无限递归），或未捕获 std::filesystem::filesystem_error（比如权限不足时直接崩溃）。
- 启用 C++17：编译时加
-std=c++17（GCC/Clang）或设置项目语言标准（MSVC） - 包含头文件：
#include，并使用命名空间namespace fs = std::filesystem; - 对每个
fs::directory_entry，先用e.is_regular_file()过滤，再用e.path().filename().string() == target_name匹配（注意大小写敏感） - 递归遍历时，用
fs::recursive_directory_iterator，但建议设fs::directory_options::skip_permission_denied防止权限报错中断
namespace fs = std::filesystem;
void search_file(const fs::path& root, const std::string& name) {
try {
for (const auto& e : fs::recursive_directory_iterator(root, fs::directory_options::skip_permission_denied)) {
if (e.is_regular_file() && e.path().filename().string() == name) {
std::cout << "Found: " << e.path().string() << "\n";
}
}
} catch (const fs::filesystem_error& ex) {
std::cerr << "FS error: " << ex.what() << "\n";
}
}
Windows 下用 FindFirstFileW / FindNextFileW（兼容旧标准）
若项目必须支持 C++11 或需精细控制（如跳过特定子目录、获取文件创建时间），Windows 原生 API 更底层可控。但必须手动处理宽字符（std::wstring）、路径拼接和递归逻辑，容易出错。
典型坑点：忘记调用 FindClose 导致句柄泄漏；用 FindFirstFileA 处理含中文路径时返回空结果；递归时未过滤 "." 和 ".." 导致死循环。
- 路径必须为宽字符串：
std::wstring root = L"C:\\temp"; - 搜索模式拼成
root + L"\\*"启动迭代，后续用FindNextFileW - 判断
cFileName是目录还是文件，靠dwFileAttributes & FILE_ATTRIBUTE_DIRECTORY - 进入子目录前，显式排除
L"."和L".."（注意宽字符串字面量）
Linux/macOS 下用 opendir + readdir（POSIX 兼容方
当目标环境不保证 C++17 支持（如嵌入式或老旧发行版），POSIX API 是最稳妥选择。但它不支持 Windows，且需手动处理路径拼接（用 snprintf 或 std::string::append），容易缓冲区溢出或路径分隔符错误。
关键陷阱：直接用 readdir 返回的 d_name 拼路径时，未检查长度是否超 PATH_MAX；未跳过 "." 和 ".."；对符号链接不做 lstat 判断就递归，导致环路。
- 用
struct stat st; lstat(full_path.c_str(), &st)区分普通文件和目录 - 拼接子路径时，确保在父路径末尾加
'/'（不能依赖输入路径是否自带） - 递归前检查
S_ISDIR(st.st_mode)且非符号链接（!S_ISLNK(st.st_mode)） - 错误处理：
opendir返回nullptr表示无权限或路径不存在，应跳过而非中止
按扩展名或内容模糊匹配的实用技巧
单纯匹配文件名太局限。实际需求常是“找所有 .log 文件”或“包含某关键词的配置文件”。标准 std::filesystem 不提供内置通配或文本搜索，需组合使用。
性能上，全盘扫内容极慢，应优先用扩展名过滤再读取；Windows/Linux 的原生 API 也不支持内容搜索，必须自己 open/fopen 并逐行比对。
- 扩展名匹配：用
e.path().extension().string() == ".txt"（注意开头带点） - 大小写不敏感：Windows 可用
_stricmp，Linux/macOS 用strcasecmp，或转小写后比较 - 内容搜索：对小文件（
st.st_size ）用std::ifstream读入内存，用std::string::find；大文件需流式读取避免 OOM - 避免重复扫描：若已知目标在某个子树，提前用
fs::is_directory判断后跳过无关分支
递归深度过深或磁盘响应慢时，std::filesystem::recursive_directory_iterator 可能卡住，此时改用基于队列的 BFS 实现更可控——但这属于进阶优化，多数场景用标准接口足矣。
