不会，std::filesystem::directory_iterator 默认只遍历指定目录的直接子项（包括文件和子目录），不递归进入子目录，本质是一层平铺。
directory_iterator 会跳过子目录里的文件吗？
不会，std::filesystem::directory_iterator 默认只遍历指定目录的**直接子项**（包括文件和子目录），但不会递归进入子目录。它本质是“一层平铺”，和 std::filesystem::recursive_directory_iterator 有明确区分。
常见误用是以为它能自动遍历整个目录树——结果发现只看到一级内容，深层文件全没出现。
- 如果只需要列出当前目录下的所有文件（不含子目录），用
directory_iterator正确且高效 - 如果目标是“找所有 .log 文件”，必须自己判断
entry.is_regular_file()，否则子目录路径也会被当作“条目”返回 - 注意：默认构造或迭代结束时，
directory_iterator{}是尾后迭代器，比较时用!=，不是==
怎么安全地遍历并避免 invalid_argument 异常？
std::filesystem::directory_iterator 构造时若路径不存在、无权限或指向非目录，会抛 std::filesystem::filesystem_error（不是 std::invalid_argument）。但很多新手在调试时看到类似错误，其实是路径传错或没加异常处理。
实操建议：
- 始终用
std::filesystem::exists(path)和std::filesystem::is_directory(path)预检，比靠 catch 更轻量 - 捕获异常时，检查
ec状态码更可靠：std::error_code ec; auto iter = std::filesystem::directory_iterator(path, ec); if (ec) { /* 处理 */ } - Windows 下注意路径分隔符：用
"C:/data"或R"(C:\data)"，避免裸反斜杠导致编译错误
为什么循环里调用 entry.path() 后再用 entry.is_regular_file() 有时返回 false？
因为 directory_entry 对象本身不缓存所有属性；多次调用 is_regular_file()、file_size() 等可能触发重复系统调用，而某些文件可能在迭代过程中被删除或重命名——这时状态不一致是正常的。
正确做法是：在一次迭代中，先用 entry.status() 获取完整 file_status，再从中提取类型和大小：
for (const auto& entry : std::filesystem::directory_iterator(path)) {
const auto stat = entry.status(); // 一次系统调用
if (stat.type() == std::filesystem::file_type::regular) {
std::cout <p>这样既避免重复 syscall，也规避了竞态导致的状态漂移。</p><h3>Linux 下中文路径遍历时乱码怎么办？</h3><p>根本原因不是 <code>directory_iterator</code> 的问题，而是 C++ 标准库对 locale 的依赖未激活。Linux 终端默认 UTF-8，但程序启动时 <code>std::locale("")</code> 可能未生效，导致 <code>std::filesystem::path</code> 内部字节解释出错。</p><p>解决方式很简单：</p>
- 在
main()开头加一句：std::locale::global(std::locale("")); - 确保编译时链接了 locale 支持（GCC/Clang 默认启用，不用额外 flag）
- 不要用
.c_str()直接传给 C 函数处理路径——改用entry.path().u8string()获取 UTF-8 字符串
漏掉 std::locale::global 这一行，哪怕路径看着正常，也可能在某些发行版（如 Alpine）上彻底失效。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
