std::filesystem::recursive_directory_iterator 默认递归遍历子目录，无需额外启用；常见误用是混淆 directory_iterator（仅一级）或未处理权限异常、符号链接循环导致中断。
std::filesystem::recursive_directory_iterator 为什么走不进子目录
默认构造的 recursive_directory_iterator 不会自动递归，必须显式启用递归行为或使用带参数的构造方式。常见错误是直接用 directory_iterator 替代，但它只遍历一级，根本不会进入子目录。
正确做法是直接使用 recursive_directory_iterator，它默认就递归遍历所有层级：
#include <filesystem>
namespace fs = std::filesystem;
for (const auto& entry : fs::recursive_directory_iterator("/path/to/dir")) {
std::cout << entry.path() << "
";
}
- 如果想跳过某些子目录（比如
.git），需手动调用pop()：在循环体内检测到目标目录时调用iter.pop() - 迭代器抛出异常（如权限不足）时默认终止，需用
fs::directory_options::skip_permission_denied控制行为 - Windows 下路径分隔符自动适配，但硬编码
"\"或"/"都可，fs::path会统一处理
如何安全捕获权限错误和符号链接循环
recursive_directory_iterator 遇到无法访问的目录（如无读权限）或符号链接构成的循环，默认会抛出 fs::filesystem_error 并中断遍历。这不是 bug，而是标准行为。
解决方法是传入选项并配合异常处理：
立即学习“C++免费学习笔记（深入）”；
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
try {
for (auto iter = fs::recursive_directory_iterator(
"/path", fs::directory_options::skip_permission_denied);
iter != fs::recursive_directory_iterator{};
++iter) {
std::cout << iter->path() << "
";
}
} catch (const fs::filesystem_error& e) {
// 只有未被选项覆盖的错误才会到这里，比如路径不存在
std::cerr << "FS error: " << e.what() << "
";
}
-
fs::directory_options::follow_symlinks是默认值，若想避免循环，改用fs::directory_options::none -
skip_permission_denied只跳过权限错误，不影响其他异常（如设备忙、路径过长） - Linux 下对挂载点（mount point）是否递归取决于底层文件系统和选项，不能假设一定跨挂载点
遍历时怎么区分文件、目录、符号链接
directory_entry 对象本身不直接暴露类型枚举，得靠 status() 或 symlink_status() 判断，二者区别很关键：
-
entry.status()返回真实目标的类型（符号链接会被解引用） -
entry.symlink_status()返回链接本身的类型（即使指向不存在的目标，也能知道它是个 link） - 判断常用写法：
is_regular_file(entry)、is_directory(entry)、is_symlink(entry)—— 这些函数内部调用的是symlink_status()，所以对符号链接本身有效
示例：
for (const auto& entry : fs::recursive_directory_iterator(path)) {
if (fs::is_directory(entry)) {
std::cout << "[DIR] " << entry.path() << "
";
} else if (fs::is_symlink(entry)) {
std::cout << "[LINK] " << entry.path() << " -> "
<< fs::read_symlink(entry).string() << "
";
} else if (fs::is_regular_file(entry)) {
std::cout << "[FILE] " << entry.path() << "
";
}
}
编译时提示 undefined reference 到 filesystem 函数
这是最常卡住新手的问题：C++17 标准虽纳入 <filesystem>，但 GCC 和 Clang 默认不链接底层库。MSVC 在 VS2019 16.10+ 后基本没问题，但 Linux/macOS 必须手动链接。
- GCC/Clang 需加
-lstdc++fs（GCC 11+）或-lstdc+++-lc++fs（Clang + libc++） - CMake 中要写：
target_link_libraries(mytarget PRIVATE stdc++fs)（GCC）或c++fs（Clang） - 确保编译器支持：GCC ≥ 8（实验性）、≥ 11（稳定）；Clang ≥ 9（需 libc++ ≥ 9）
- 不是所有平台都完整实现：Android NDK、某些嵌入式 STL 可能完全缺失
std::filesystem
没链接库时的典型错误是 undefined reference to 'std::filesystem::u8path' 或类似符号，不是头文件没包含的问题。
真正麻烦的是跨平台构建时，std::filesystem 的行为细节（比如路径规范化、大小写敏感性、对非法 UTF-8 的处理）在不同系统上并不一致，别指望一次写完就能在 Windows/macOS/Linux 上表现完全相同。
