std::filesystem::recursive_directory_iterator是首选，因它封装Windows/POSIX底层API，自动处理路径分隔符、符号链接（默认跳过防循环）、权限异常（需try/catch），跨平台且无需第三方库。
直接用 std::filesystem 就行，C++17 起已原生支持跨平台递归遍历，无需第三方库，但要注意编译器和标准库实现差异。
为什么 std::filesystem::recursive_directory_iterator 是首选
它封装了 Windows 的 FindFirstFileEx 和 POSIX 的 fts_open（或 scandir），自动处理路径分隔符、符号链接、权限拒绝等细节。比手写递归 + opendir/FindFirstFile 更安全、更简洁。
- 默认跳过符号链接（避免循环引用），加
std::filesystem::directory_options::follow_directory_symlink才跟随 - 遇到权限不足目录（如
/proc/1/ns）会抛std::filesystem::filesystem_error，需 try/catch - Windows 下对长路径（>260 字符）支持依赖编译器：MSVC 需启用
/Zc:__cplusplus且项目配置中开启“长路径支持” - Clang/libc++ 在 macOS 上需链接
-lc++fs（Xcode 14+ 默认启用，旧版要手动加）
最简可用代码模板（含错误处理）
以下代码在 GCC 9+、Clang 10+、MSVC 2019+ 均可编译运行，关键点是捕获异常并区分“访问被拒”和“路径不存在”：
#include <filesystem>
#include <iostream>
namespace fs = std::filesystem;
void traverse(const fs::path& root) {
try {
for (const auto& entry : fs::recursive_directory_iterator(root)) {
if (entry.is_regular_file()) {
std::cout << "file: " << entry.path() << "
";
} else if (entry.is_directory()) {
std::cout << "dir: " << entry.path() << "
";
}
}
} catch (const fs::filesystem_error& e) {
// 注意：e.code().value() == 5 (EACCES) 表示权限拒绝，不是致命错误
if (e.code().value() == 5) {
std::cerr << "skipped: " << e.path1() << " (access denied)
";
} else {
throw; // 其他错误（如路径格式错）仍需上报
}
}
}
常见陷阱与绕过方式
实际用时最容易栽在三类问题上：
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
立即学习“C++免费学习笔记（深入）”；
-
std::filesystem::recursive_directory_iterator构造时若传入非法路径（如空字符串、含fs::exists(path)或fs::is_directory(path)校验 - 某些旧版 libstdc++（GCC 8 及更早）不完全支持
recursive_directory_iterator的异常语义，建议升级到 GCC 9+ 或显式检查__cpp_lib_filesystem >= 201703L - 遍历大目录时性能敏感？避免在循环内频繁调用
entry.path().string()（触发内存分配），改用entry.path().c_str()或提前缓存entry.path()到局部变量 - 需要过滤特定后缀（如
.log）？别在循环里用entry.path().extension() == ".log"——extension()返回".log"，但路径可能为"archive.log.gz"，应改用entry.path().filename().string().ends_with(".log")（C++20）或手动rfind
Windows 下的特殊注意事项
即使启用了 C++17，MSVC 默认仍禁用长路径支持，导致 \?C: erylongpath 类路径失败：
- 项目属性 → “常规” → “启用 Windows 长路径支持” 设为“是”（VS2019+）
- 或手动在
manifest文件中添加<application xmlns="urn:schemas-microsoft-com:asm.v3"><windowsSettings><longPathAware xmlns="http://schemas.microsoft.com/SMI/2016/WindowsSettings">true</longPathAware></windowsSettings></application> - 避免用
std::filesystem::u8path处理 UTF-8 字符串路径 —— Windows API 底层用 UTF-16，u8path在 MSVC 中有已知 bug（VS2022 17.4 修复），建议统一用std::filesystem::path+ 系统 locale
真正麻烦的从来不是写几行遍历代码，而是当某台 Linux 机器上 /sys 目录触发几百次 permission denied、或者某客户 Windows 7 机器因没开长路径支持直接 crash 时，你得知道该查哪一行日志、该关哪个 flag。
