std::filesystem::recursive_directory_iterator 是 C++17 原生递归遍历方案，需用 try/catch 捕获 filesystem_error，推荐构造时传入 skip_permission_denied 选项，并检查 directory_entry 有效性后再调用 is_directory() 或 path()。
用 std::filesystem::recursive_directory_iterator 最直接
这是 C++17 标准提供的原生方案，不用第三方库，也不用自己写递归逻辑。它内部自动处理目录栈和符号链接（默认不跟随），遍历顺序是深度优先。
常见错误是忽略异常——比如权限不足或路径被删除时，迭代器可能抛出 std::filesystem::filesystem_error。不捕获的话程序直接崩溃。
- 必须用
try/catch包裹迭代循环，尤其在生产环境遍历用户目录或系统路径时 - 构造时传入
std::filesystem::directory_options::skip_permission_denied可跳过无权访问的目录，避免中断整个遍历 - 每个
std::filesystem::directory_entry对象调用.is_directory()或.path()前，先确认它是否有效（某些平台对损坏 symlink 的行为不一致）
for (auto it = std::filesystem::recursive_directory_iterator("/tmp", ec); it != std::filesystem::recursive_directory_iterator(); ++it) {
if (ec) { /* 处理错误 */ continue; }
if (it->is_regular_file()) {
std::cout << it->path() << "\n";
}
}想跳过符号链接？得关掉 follow_symlinks
默认情况下，recursive_directory_iterator 不跟随符号链接，但它的行为受构造选项影响。如果你发现遍历意外进入了某个软链指向的深层目录，大概率是误用了 std::filesystem::directory_options::follow_directory_symlink。
这个选项只在构造迭代器时生效，且仅对“目录型符号链接”起作用（普通文件软链不影响遍历）。一旦开启，它会把软链目标当作真实子目录压入遍历栈，容易造成无限循环（比如软链指向父目录）。
立即学习“C++免费学习笔记（深入）”；
专业股权研究自动化系统，支持6,000-10,000字首发覆盖报告和3,000-5,000字季报更新报告。触发词：股票研究、深度研究、首发覆盖、季报更新、DCF估值。
- 明确不需要软链展开时，不要传任何
directory_options参数，保持默认安全行为 - 真要跟随软链，务必配合
std::filesystem::recursive_directory_iterator::depth()限制最大嵌套层数，防止环状链接炸栈 - Windows 上符号链接支持依赖于启用开发者模式或管理员权限，否则
is_symlink()可能返回 false 正负结果
性能敏感场景下，std::filesystem::directory_iterator + 手动栈更可控
当你要跳过特定名称的目录（如 .git、node_modules）、按修改时间剪枝、或做并发扫描时，标准递归迭代器太死板——它不支持中途跳过子树，也不能暂停/恢复。
这时候改用手动维护栈结构，用 std::filesystem::directory_iterator 配合 std::stack 或 std::vector，每层只展开当前目录，遇到要跳过的路径直接 continue。
- 内存占用更可预测：不会一次性把整个目录树元数据加载进内存
- 可以自然实现广度优先遍历，适合多线程分片（比如每个线程处理栈中一个子目录）
- 注意
directory_iterator是前向迭代器，不可复制多次使用；每次进入新目录都要新建一个实例
跨平台要注意路径分隔符和权限语义差异
Linux/macOS 下 /tmp/foo 和 /tmp/foo/（末尾斜杠）在 recursive_directory_iterator 构造时行为一致；但 Windows 对末尾反斜杠更敏感，某些旧版本 MSVC 会因路径末尾多一个 \ 导致 filesystem_error 报错码为 not_a_directory。
另外，std::filesystem::status() 在不同系统上对“可执行”“可写”的判定逻辑不同：Linux 看 inode 权限位，Windows 看 ACL，而 WSL2 又夹在中间。别用 is_executable() 判断脚本能否运行。
- 构造路径统一用
std::filesystem::path拼接，别手拼字符串加/或\ - 判断目录可读性，优先用
std::filesystem::exists(p) && std::filesystem::is_directory(p)，而不是依赖status().permissions() - macOS APFS 卷上硬链接和克隆文件可能让
file_size()返回 0，但实际内容非空——如果按大小过滤，得额外检查is_regular_file()后再读取
递归遍历看着简单，真正鲁棒的实现得同时扛住权限突变、路径重命名、符号链接环、跨文件系统挂载点这四类干扰。标准库只帮你做了最外层骨架，里子还得自己一层层补。
