需传入 std::filesystem::directory_options::follow_symlinks 选项：构造 recursive_directory_iterator 时显式指定该标志，即可使迭代器遍历符号链接指向的目标目录而非跳过。
recursive_directory_iterator 会跳过符号链接，怎么让它也遍历？
默认情况下 std::filesystem::recursive_directory_iterator 遇到符号链接（symlink）会直接跳过，不进入也不报错——这和很多用户直觉不符，尤其想递归扫描整个挂载点或软链指向的目录时。
解决方法是构造时传入 std::filesystem::directory_options::follow_symlinks：
for (auto it = std::filesystem::recursive_directory_iterator("/path", std::filesystem::directory_options::follow_symlinks); it != std::filesystem::recursive_directory_iterator{}; ++it) {
std::cout << it->path() << "
";
}
注意：若 symlink 指向的是循环路径（比如 A → B → A），follow_symlinks 不会自动检测环路，可能引发无限递归或抛出 std::filesystem::filesystem_error（错误码为 std::errc::too_many_levels_of_symbolic_links）。生产环境建议配合深度限制或已访问路径集合做防护。
遍历时遇到权限拒绝（Permission denied）就崩溃？
当迭代器碰到无读取权限的目录（如 /root 或某些系统目录），默认行为是抛出 std::filesystem::filesystem_error，程序直接终止。
立即学习“C++免费学习笔记（深入）”；
必须用异常处理兜底，且推荐在构造迭代器时启用“跳过错误”模式：
- 传入
std::filesystem::directory_options::skip_permission_denied - 再用
try/catch包裹单次++it或it++（因为错误可能发生在递增时，而非构造时）
典型写法：
std::filesystem::recursive_directory_iterator it{"/path"}, end{};
while (it != end) {
try {
std::cout << it->path() << "
";
++it;
} catch (const std::filesystem::filesystem_error& e) {
if (e.code() == std::errc::permission_denied) {
++it; // 跳过该条目，继续
} else {
throw; // 其他错误不吞
}
}
}
如何控制最大递归深度避免栈溢出？
recursive_directory_iterator 内部用栈模拟递归，但标准库未暴露深度控制接口。深度过大（如几十层嵌套+大量子目录）可能耗尽栈空间或拖慢性能。
实际可行的控制方式只有两种：
- 手动计数：每次
++it后调用it.depth()获取当前层级（从 0 开始），超过阈值就pop()回退 - 改用非递归方式：用
std::filesystem::directory_iterator+ 显式std::stack管理待遍历路径，完全自主控制深度和顺序
it.depth() 是唯一能获取当前层级的接口，但它只在进入新目录时更新，且 pop() 会立即减少深度并跳到同级下一个项——适合粗粒度限深，不适合精确剪枝。
Windows 下遍历网络路径或 OneDrive 同步目录容易卡住
在 Windows 上，recursive_directory_iterator 对 UNC 路径（如 \servershare）或云同步目录（OneDrive、Google Drive）响应极慢，甚至长时间阻塞在某个条目上，原因通常是底层文件系统驱动返回状态超时。
缓解手段有限，最有效的是：
- 设置操作超时：无法直接设，但可把遍历逻辑放到独立线程中，主逻辑用
std::thread::join_for()或std::future::wait_for()控制总耗时 - 跳过可疑路径：提前用
std::filesystem::is_symlink()和std::filesystem::status()过滤掉已知慢设备（如OneDrive文件夹名、~$临时文件） - 禁用
follow_symlinks：某些云盘会把同步状态伪装成 symlink，跟进去反而更慢
没有银弹——这类问题本质是 OS 层面的 I/O 延迟，C++ 标准库只能被动响应。
