std::filesystem::recursive_directory_iterator 是 c++17 起标准库提供的递归遍历工具，自动跳过符号链接、处理循环引用，需包含 头文件并注意编译选项；解引用得 directory_entry，用 .path() 和 .is_regular_file() 等方法操作。
用 std::filesystem::recursive_directory_iterator 遍历最直接
标准库从 C++17 开始提供 std::filesystem，recursive_directory_iterator 是专为递归遍历设计的，比手写栈或递归函数更安全、语义更清晰。它自动跳过符号链接（除非显式启用），并能正确处理循环引用（如挂载点或硬链接环）。
常见错误是误用 directory_iterator——它只遍历一级子项，不会进入子目录；还有人忘记在循环中检查 is_regular_file()，结果把目录、socket、设备文件等都当普通文件处理。
- 必须包含头文件：
#include <filesystem></filesystem>，编译时加-lstdc++fs（GCC 旧版本）或确保标准库支持完整 filesystem（Clang 10+/MSVC 2019+） - 迭代器默认跳过符号链接，如需跟随，构造时传入
std::filesystem::directory_options::follow_directory_symlink - 每次解引用迭代器得到的是
std::filesystem::directory_entry，要获取路径用.path()，判断类型用.is_regular_file()或.is_directory()
for (const auto& entry : std::filesystem::recursive_directory_iterator("/tmp")) {
if (entry.is_regular_file()) {
std::cout
<h3>遇到权限不足或路径不存在时会抛异常</h3>
<p><code>recursive_directory_iterator</code> 在首次构造或 ++ 操作时，如果遇到无权限访问的子目录（如 <code>/root/.ssh</code>）、已删除的路径、或挂载失效的 NFS 目录，会抛出 <code>std::filesystem::filesystem_error</code>。不捕获就直接 crash。</p>
<p>这不是“错误用法”，而是设计使然：filesystem 要求明确表达错误意图，而不是静默跳过。实际项目中必须处理。</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill9399" title="Systematic Debug"><img
src="https://img.php.cn/upload/skill/000/000/081/179258048856567.jpg" alt="Systematic Debug" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/skill9399" title="Systematic Debug" class="overflowclass">Systematic Debug</a>
<p class="overflowclass">基于假设的调试 — 观察/假设/隔离/验证/修复</p>
</div>
<a rel="nofollow" href="/xiazai/skill9399" title="Systematic Debug" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div>
- 用
try/catch包裹整个循环，或在循环内对每个entry.path()单独 try（后者可继续遍历其余路径） - 检查异常码：
ex.code().value()为EACCES（13）表示权限拒绝，ENOENT（2）表示路径不存在 - 若想静默跳过不可访问目录，可用
std::filesystem::directory_options::skip_permission_denied选项构造迭代器（C++17 起支持）
std::filesystem::recursive_directory_iterator 的性能与遍历顺序
它内部使用系统 API（Linux 上是 ftw 或 openat+getdents），性能接近原生 syscall，但比自己用 opendir/readdir 多一次路径拼接开销。对百万级小文件，差异可测但通常不构成瓶颈。
遍历顺序不保证：标准未规定是深度优先还是广度优先，实际取决于底层实现和文件系统排序（ext4 通常是字典序，但 NTFS 可能不同）。不要依赖顺序做逻辑判断。
- 如需稳定顺序（比如测试一致性），遍历完存入
std::vector后调用std::sort - 避免在循环中频繁调用
entry.path().filename()或entry.path().extension()——它们会重复解析路径字符串；可先存为局部变量 - 若只需文件名不含路径，用
entry.path().stem()比entry.path().filename().replace_extension("")更简洁
Windows 下要注意路径分隔符和长路径限制
虽然 std::filesystem 自动处理正反斜杠转换，但在 Windows 上，如果路径以 \? 开头（启用长路径），recursive_directory_iterator 可能失败或行为异常——它不完全兼容这种扩展语法。
另外，Windows 默认禁用长路径（>260 字符），即使代码用了 std::filesystem，底层仍可能报 ERROR_FILENAME_EXCED_RANGE。
- 开发时确保系统已启用长路径支持（注册表或组策略），或在构建前用
GetFullPathNameA预处理路径 - 避免手动拼接路径字符串，一律用
std::filesystem::path的/运算符，比如root / "sub" / "file.txt" - 调试时打印
entry.path().generic_string()而非.string()，避免 Windows 下宽字符转码问题导致乱码
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
