C++ filesystem怎么递归遍历子目录-C++-PHP中文网

std::filesystem::recursive_directory_iterator 是 c++17 原生递归遍历方案，需用 try/catch 捕获 filesystem_error，推荐构造时传入 skip_permission_denied 选项，并检查 directory_entry 有效性后再调用 is_directory() 或 path()。

c++ filesystem怎么递归遍历子目录

用 `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 path() <h3>想跳过符号链接？得关掉 <code>follow_symlinks</code>
</h3><p>默认情况下，<code>recursive_directory_iterator</code> 不跟随符号链接，但它的行为受构造选项影响。如果你发现遍历意外进入了某个软链指向的深层目录，大概率是误用了 <code>std::filesystem::directory_options::follow_directory_symlink</code>。</p><p>这个选项只在构造迭代器时生效，且仅对“目录型符号链接”起作用（普通文件软链不影响遍历）。一旦开启，它会把软链目标当作真实子目录压入遍历栈，容易造成无限循环（比如软链指向父目录）。</p>

明确不需要软链展开时，不要传任何 directory_options 参数，保持默认安全行为
真要跟随软链，务必配合 std::filesystem::recursive_directory_iterator::depth() 限制最大嵌套层数，防止环状链接炸栈
Windows 上符号链接支持依赖于启用开发者模式或管理员权限，否则 is_symlink() 可能返回 false 正负结果

性能敏感场景下，`std::filesystem::directory_iterator` + 手动栈更可控

当你要跳过特定名称的目录（如 .git、node_modules）、按修改时间剪枝、或做并发扫描时，标准递归迭代器太死板——它不支持中途跳过子树，也不能暂停/恢复。

Stock Research System

专业股权研究自动化系统，支持6,000-10,000字首发覆盖报告和3,000-5,000字季报更新报告。触发词：股票研究、深度研究、首发覆盖、季报更新、DCF估值。

下载

这时候改用手动维护栈结构，用 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() 后再读取

递归遍历看着简单，真正鲁棒的实现得同时扛住权限突变、路径重命名、符号链接环、跨文件系统挂载点这四类干扰。标准库只帮你做了最外层骨架，里子还得自己一层层补。