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