c++oding="utf-8" ?>
C++17起，std::filesystem::directory_iterator不支持内置后缀过滤，必须手动检查path.extension()并配合is_regular_file()等判断，且需注意跨平台路径编码、隐藏文件、空扩展名及性能优化等问题。
用 std::filesystem::directory_iterator 遍历指定文件夹并过滤后缀
直接结论：C++17 起，std::filesystem::directory_iterator 本身不支持内置后缀过滤，必须手动判断 path.extension() —— 想靠构造参数或迭代器选项“一键过滤”会失败。
常见错误现象是误以为能像 Python 的 glob 那样传个模式进去，结果编译报错或遍历全部文件无过滤。根本原因是这个迭代器只负责“走进目录”，不处理匹配逻辑。
- 必须显式调用
path.extension()，它返回的是std::filesystem::path类型，比较时建议转成string()或用==直接比（注意大小写） - Windows 下文件扩展名默认小写，但用户可能存为
.JPG；Linux 区分大小写，".txt"不会匹配".TXT" - 有些文件没扩展名（如
Makefile），path.extension().empty()为true，别漏掉这个分支
path.extension() 和 path.stem() 的区别与误用场景
很多人想“排除隐藏文件”或“只取文件名不含点的部分”，结果错用 extension() —— 它只返回最后一个点之后的内容（如 "a.b.c" 的 extension() 是 ".c"），不是整个后缀集合。
典型误用：用 path.extension() == ".log" 判断，却忘了 path 可能是目录（is_regular_file() 未检查），导致程序把文件夹当普通文件处理。
- 务必先用
fs::is_regular_file(entry)过滤掉子目录和符号链接 - 若需忽略隐藏文件（以
.开头），检查path.filename().string()[0] == '.'（注意空字符串防护） -
path.stem()返回去掉扩展名的部分（"a.b.c"→"a.b"），不是“主文件名”，别指望它切掉所有点
Windows 下路径编码和中文路径崩溃问题
在 VS2019+ 或 MinGW-w64 上，如果路径含中文，directory_iterator 构造可能抛 std::filesystem::filesystem_error，错误信息类似 "No such file or directory"，即使路径真实存在。
这不是代码逻辑问题，而是 C++ 标准库对 Windows UTF-16 路径的桥接缺陷。MSVC 默认用窄字符接口调用 Win32 API，遇到非 ASCII 字符就解码失败。
- MSVC 下推荐用宽字符字面量：
fs::directory_iterator{L"中文目录"}，且确保源文件保存为 UTF-8 with BOM 或 UTF-16 - MinGW-w64 需定义
_GLIBCXX_FILESYSTEM_IS_WINDOWS并链接-lstdc++fs，否则std::filesystem功能不全 - 跨平台项目里，避免硬编码路径，改用
argv[0]推导或让用户输入时做MultiByteToWideChar转换（仅 Windows）
性能敏感时别用 directory_iterator 做递归遍历
如果目标是“某目录下所有 .cpp 文件（含子目录）”，直接套两层 for 循环嵌套 directory_iterator + 递归调用，会显著变慢 —— 每次进入子目录都触发一次系统调用，且无法利用现代文件系统预读机制。
更优解是改用 std::filesystem::recursive_directory_iterator，它底层做了路径栈缓存和单次目录批读取优化。
-
recursive_directory_iterator默认跳过符号链接，如需跟随，构造时加fs::directory_options::follow_directory_symlink - 它也**不支持构造时过滤**，仍要手动判断
extension()和is_regular_file() - 遍历时可用
iter.depth()控制最大递归深度，防无限软链循环
最易被忽略的一点：std::filesystem 在旧版 GCC（-lstdc++fs，否则链接时报 undefined reference to 'std::filesystem::...' —— 错误信息里没有“filesystem”字样，只有一长串 mangled 名，很难联想到是缺链接库。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
