C++如何使用std::filesystem::recursive_directory

c++oding="utf-8" ?>

默认不跟随符号链接，需显式传std::filesystem::directory_options::follow_symlinks选项才能进入；否则跳过且不报错，但存在循环引用风险导致抛出too_many_symbolic_links错误。

c++如何使用std::filesystem::recursive_directory_iterator

recursive_directory_iterator 会跳过符号链接，怎么让它遍历进去

默认情况下 std::filesystem::recursive_directory_iterator 不会跟随符号链接（symlink），遇到它就直接跳过——这不是 bug，是标准规定的安全默认行为。如果目标路径下有指向子目录的符号链接，且你希望递归进入，必须显式启用 follow_symlinks 选项。

构造时传入 std::filesystem::directory_options::follow_symlinks，例如：

for (auto it : std::filesystem::recursive_directory_iterator(path, std::filesystem::directory_options::follow_symlinks)) { ... }

不加这个选项时，it->is_symlink() 可能返回 true，但迭代器已跳过该条目，不会出现在遍历序列中
注意循环引用风险：若符号链接形成闭环（如 A → B → A），启用 follow_symlinks 后可能无限递归，程序抛出 std::filesystem::filesystem_error（错误码为 std::errc::too_many_symbolic_links）

遍历时如何安全判断是否为目录或文件

不能只依赖 it->status().type()，因为对符号链接，它返回的是链接目标的类型；而 it->symlink_status().type() 才反映链接本身的类型（比如 file_type::symlink）。实际使用中，多数场景应优先用 is_directory() 或 is_regular_file() 成员函数，它们内部已按需选择 status/symlink_status。

C++14

C++14 对 C++11 的修正与增强版本，适合旧系统维护和较老工具链兼容。

下载

it->is_directory()：等价于 it->status().type() == file_type::directory，适用于普通目录和解析后的符号链接目录
it->is_symlink()：等价于 it->symlink_status().type() == file_type::symlink，可单独检测链接本身
避免直接调用 it->status() 后再手动判 type——在某些文件系统或权限受限路径下，status() 可能抛异常，而 is_* 函数做了异常防护（C++20 起保证 noexcept）

为什么循环里修改目录结构会导致未定义行为

recursive_directory_iterator 在构造时会缓存当前层级的目录项列表。如果在遍历过程中，通过 std::filesystem::remove()、create_directory() 等操作修改了正在遍历的目录内容（尤其是当前层级），后续迭代行为是未定义的——可能跳过新创建项、重复访问已删项，甚至崩溃。

安全做法：先收集所有要处理的路径到容器（如 std::vector<:filesystem::path></:filesystem::path>），再统一操作
若必须边遍历边删，改用非递归的 std::filesystem::directory_iterator + 手动栈管理，并在每次 push_back 子目录前确认其仍存在
Windows 上尤其敏感：NTFS 的重解析点与目录句柄持有机制会让问题更隐蔽

跨平台编译失败？检查 C++ 标准和运行时支持

即使写了正确代码，std::filesystem 在部分旧环境仍不可用：GCC 8+ 默认启用，但需链接 -lstdc++fs；MSVC 2017 Update 5+ 支持，但 Windows 7 需要 KB2999226 补丁；Clang 7+ 依赖 libc++ 或 libstdc++ 版本。

编译时确认标准：必须加 -std=c++17 或更高（C++20 仅增强部分功能，非必需）
Linux 下 GCC 9 以前版本，链接时漏掉 -lstdc++fs 会报 undefined reference 到 recursive_directory_iterator 构造函数
macOS 上 Clang 使用 libc++ 时，std::filesystem 是完整实现；但若项目混用 Homebrew GCC，则可能因 ABI 不兼容静默失败

递归遍历看似简单，真正棘手的是状态一致性——链接是否跟随、目录是否被并发修改、错误是否被静默吞掉。这些细节不会在文档首行写明，但会在某次部署后突然暴露。