C++17中推荐使用std::filesystem遍历目录,通过recursive_directory_iterator递归访问所有文件和子目录,示例代码展示了路径检查、文件类型判断及扩展名过滤;若仅遍历当前目录则使用directory_iterator,可结合extension()等方法筛选特定文件;旧版本C++可用Boost.Filesystem或系统API如POSIX的opendir/readdir实现跨平台兼容。

在 C++ 中遍历文件夹下的所有文件,可以使用多种方法。从 C++17 开始,标准库引入了
使用 C++17 filesystem 遍历目录
C++17 提供的 std::filesystem 是最推荐的方式,跨平台且语法简洁。
要遍历某个目录下的所有文件(包括子目录),可以使用 std::filesystem::recursive_directory_iterator;如果只遍历当前目录,使用 std::filesystem::directory_iterator。
示例代码:
立即学习“C++免费学习笔记(深入)”;
#include#include namespace fs = std::filesystem;
void traverse_directory(const std::string& path) { if (!fs::exists(path) || !fs::is_directory(path)) { std::cout << "路径不存在或不是目录: " << path << "\n"; return; }
for (const auto& entry : fs::recursive_directory_iterator(path)) { if (fs::is_regular_file(entry.status())) { std::cout << "文件: " << entry.path().string() << "\n"; } else if (fs::is_directory(entry.status())) { std::cout << "目录: " << entry.path().string() << "\n"; } }}
int main() { traverse_directory("C:\test"); // Windows 示例 // traverse_directory("/home/user"); // Linux 示例 return 0; }
编译时注意: 需启用 C++17 并链接 filesystem 库(如 GCC/Clang):
g++ -std=c++17 main.cpp -lstdc++fs(部分旧版本需要)仅遍历当前目录(非递归)
若不需要进入子目录,替换迭代器即可:
for (const auto& entry : fs::directory_iterator(path)) { if (entry.is_regular_file()) { std::cout << "文件: " << entry.path().filename().string() << "\n"; } }path().filename() 获取文件名,path().string() 获取完整路径。
过滤特定类型文件
可以通过文件扩展名进行筛选:
if (entry.is_regular_file()) { if (entry.path().extension() == ".txt") { std::cout << "文本文件: " << entry.path() << "\n"; } }常用方法:
- entry.path().extension():获取扩展名(如 .cpp)
- entry.path().stem():获取文件名不含扩展名
- entry.path().parent_path():获取父目录
兼容旧版本 C++(如 C++11/14)
若无法使用 C++17,可考虑:
- Boost.Filesystem:功能与 std::filesystem 几乎一致,是其前身。
- Windows API(Win32 FindFirstFile/FindNextFile)
- POSIX opendir()/readdir()(Linux/macOS)
例如使用 POSIX:
#include#include void list_files_posix(const std::string& path) { DIR* dir = opendir(path.c_str()); if (!dir) return;
struct dirent* ent; while ((ent = readdir(dir)) != nullptr) { if (ent->d_type == DT_REG) { // 普通文件 std::cout << "文件: " << ent->d_name << "\n"; } } closedir(dir);}
此方法不跨平台,需分别实现 Windows 和 Unix 版本。
基本上就这些。优先使用 C++17 的 filesystem,清晰、安全、可移植。路径操作时注意斜杠方向和权限问题,递归遍历时避免符号链接导致无限循环。不复杂但容易忽略细节。









