c++oding="utf-8" ?>
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
<ul>
<li>如果想跳过某些子目录（比如 <code>.git</code>），需手动调用 <code>pop()</code>：在循环体内检测到目标目录时调用 <code>iter.pop()</code>
</li>
<li>迭代器抛出异常（如权限不足）时默认终止，需用 <code>fs::directory_options::skip_permission_denied</code> 控制行为</li>
<li>Windows 下路径分隔符自动适配，但硬编码 <code>"\"</code> 或 <code>"/"</code> 都可，<code>fs::path</code> 会统一处理</li>
</ul>
<h3>如何安全捕获权限错误和符号链接循环</h3>
<p><code>recursive_directory_iterator</code> 遇到无法访问的目录（如无读权限）或符号链接构成的循环，默认会抛出 <code>fs::filesystem_error</code> 并中断遍历。这不是 bug，而是标准行为。</p>
<p>解决方法是传入选项并配合异常处理：</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/gongju/2823" title="C++14"><img
src="https://img.php.cn/upload/manual/001/431/639/6ac8b33c327c4749.png" alt="C++14" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/gongju/2823" title="C++14" class="overflowclass">C++14</a>
<p class="overflowclass">C++14 对 C++11 的修正与增强版本，适合旧系统维护和较老工具链兼容。</p>
</div>
<a rel="nofollow" href="/xiazai/gongju/2823" title="C++14" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div>
<pre class="brush:php;toolbar:false;">try {
for (auto iter = fs::recursive_directory_iterator(
"/path", fs::directory_options::skip_permission_denied);
iter != fs::recursive_directory_iterator{};
++iter) {
std::cout path()
-
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 "
<h3>编译时提示 undefined reference 到 filesystem 函数</h3>
<p>这是最常卡住新手的问题：C++17 标准虽纳入 <code><filesystem></filesystem></code>，但 GCC 和 Clang 默认不链接底层库。MSVC 在 VS2019 16.10+ 后基本没问题，但 Linux/macOS 必须手动链接。</p>
- 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 上表现完全相同。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
