c++17起推荐用std::filesystem::directory_iterator遍历目录，仅当前层、跨平台、需调用.path().filename().string()提取文件名，注意异常处理；递归用recursive_directory_iterator，win32备选方案需宽字符且不跨平台。
用 std::filesystem::directory_iterator 遍历目录最直接
这是 C++17 起标准库提供的方案，无需第三方依赖，跨平台（Windows/macOS/Linux 均支持），且语义清晰。关键点在于：它只遍历**当前层级**，不递归；返回的是 std::filesystem::directory_entry 对象，需调用 .path() 获取完整路径，再用 .filename() 提取纯文件名。
常见错误是直接打印 entry——那会输出完整路径；或者忽略异常（比如权限不足时迭代器构造可能抛 std::filesystem::filesystem_error）。
示例代码片段：
#include <filesystem>
#include <iostream>
namespace fs = std::filesystem;
for (const auto& entry : fs::directory_iterator("/path/to/dir")) {
std::cout
<ul>
<li>确保编译器启用 C++17 或更高标准（如 <code>g++ -std=c++17</code>）</li>
<li>Windows 下路径分隔符用正斜杠 <code>/</code> 或双反斜杠 <code>\</code> 均可，<code>std::filesystem</code> 会自动适配</li>
<li>若需过滤掉子目录，加判断：<code>if (!entry.is_directory())</code>
</li>
</ul>
<h3>需要递归列出所有文件（含子目录）就用 <code>std::filesystem::recursive_directory_iterator</code>
</h3>
<p>名字长但意图明确：它会深度优先遍历整个目录树。和普通迭代器一样，每个 <code>entry</code> 仍是 <code>directory_entry</code> 类型，操作方式一致。</p>
<p>容易被忽略的点是：默认情况下它会跳过符号链接指向的目标（即不跟随 symlink），如果需要跟随，得传入 <code>fs::directory_options::follow_directory_symlink</code> 参数；另外，递归过程中遇到无法访问的目录（如无权限）会抛异常，建议用 <code>try/catch</code> 包裹迭代循环。</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>
<ul>
<li>递归版代码只需把 <code>directory_iterator</code> 换成 <code>recursive_directory_iterator</code>
</li>
<li>若只要文件名不要路径，仍用 <code>.filename().string()</code>；若要相对路径（从起始目录算起），可用 <code>entry.path().lexically_relative(start_path)</code>
</li>
<li>性能上，递归迭代器比多层嵌套循环更简洁，但对极深目录树要注意栈开销（实际极少成为瓶颈）</li>
</ul>
<h3>Windows 下用 <code>FindFirstFileW</code> / <code>FindNextFileW</code> 是兼容老项目的备选</h3>
<p>如果你的项目不能升级到 C++17，或必须支持 Windows XP 等旧系统，这套 Win32 API 仍可靠。注意必须用宽字符版本（<code>W</code> 后缀），否则中文路径会乱码；返回的 <code>WIN32_FIND_DATAW</code> 结构里，<code>cFileName</code> 字段才是文件名（不含路径）。</p>
<p>典型坑点：第一次调用 <code>FindFirstFileW</code> 传入的路径模式必须带通配符，例如 <code>L"C:\mydir\*"</code>，而不是 <code>L"C:\mydir"</code>；循环结束时必须调用 <code>FindClose</code>，否则句柄泄漏。</p>
<ul>
<li>只适用于 Windows，不可跨平台</li>
<li>需手动跳过 <code>"."</code> 和 <code>".."</code> 目录项（<code>dwFileAttributes & FILE_ATTRIBUTE_DIRECTORY</code> 判断是否为目录，再比对名称）</li>
<li>不支持 UTF-8 编码的路径字符串，输入必须是 UTF-16 宽字符串</li>
</ul>
<h3>避免把 <code>std::filesystem::path</code> 当字符串拼接来用</h3>
<p>新手常犯的错：拿到 <code>entry.path()</code> 后用 <code>+</code> 拼接字符串得到“文件名”，比如 <code>entry.path().string() + ".bak"</code>。这在 Linux 下可能侥幸工作，但在 Windows 下路径分隔符是 <code>\</code>，拼接后容易变成 <code>C:dir ile.txt.bak</code> 这种非法结构。</p>
<p>正确做法永远是用 <code>path</code> 类的方法组合：</p>
<pre class="brush:php;toolbar:false;">fs::path p = entry.path();
fs::path new_path = p.parent_path() / (p.filename().stem() += ".bak");
-
/是重载的路径拼接操作符，自动处理分隔符 -
.stem()返回不带扩展名的文件名，.extension()返回扩展名，比字符串切分安全得多 - 所有
std::filesystem::path操作都保留原始编码和 Unicode 支持，不经过窄字符串中转
真正麻烦的从来不是“怎么列出来”，而是后续对这些文件名做路径操作时，没用对 path 接口导致跨平台出错或 Unicode 截断——这点比迭代方式本身更值得花时间确认。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
