在C++开发场景中，经常需要获取某个文件夹下的所有文件，包括子文件夹中的嵌套文件，这时候就需要用到目录递归遍历的逻辑。不同操作系统下的目录操作接口存在差异，下面分别介绍Linux和Windows系统下的实现方式以及通用技巧。
Linux系统下的实现方法
Linux系统下可以使用<dirent.h>头文件提供的opendir、readdir、closedir等函数实现目录遍历，核心思路是先打开目录，循环读取目录项，判断目录项是否为子目录，如果是则递归调用遍历函数，否则记录文件路径。
核心函数说明
opendir：打开指定路径的目录，返回目录流指针readdir：读取目录流中的下一个目录项，返回dirent结构体指针closedir：关闭打开的目录流，释放资源
示例代码
#include <iostream>
#include <dirent.h>
#include <string>
#include <vector>
// 递归遍历目录，将文件路径存入result列表
void traverse_dir(const std::string& dir_path, std::vector<std::string>& result) {
DIR* dir = opendir(dir_path.c_str());
if (dir == nullptr) {
std::cerr << "无法打开目录: " << dir_path << std::endl;
return;
}
struct dirent* entry;
while ((entry = readdir(dir)) != nullptr) {
// 跳过当前目录和上级目录标识
if (strcmp(entry->d_name, ".") == 0 || strcmp(entry->d_name, "..") == 0) {
continue;
}
std::string full_path = dir_path + "/" + entry->d_name;
// 判断是否为目录，DT_DIR是目录类型标识
if (entry->d_type == DT_DIR) {
// 递归遍历子目录
traverse_dir(full_path, result);
} else {
// 普通文件，加入结果列表
result.push_back(full_path);
}
}
closedir(dir);
}
int main() {
std::string target_dir = "./test_dir";
std::vector<std::string> all_files;
traverse_dir(target_dir, all_files);
std::cout << "目录下的所有文件：" << std::endl;
for (const auto& file : all_files) {
std::cout << file << std::endl;
}
return 0;
}
Windows系统下的实现方法
Windows系统下可以使用<windows.h>头文件提供的FindFirstFile、FindNextFile、FindClose等函数实现目录遍历，逻辑和Linux下类似，只是接口名称和参数不同。
示例代码
#include <iostream>
#include <windows.h>
#include <string>
#include <vector>
// 递归遍历目录，将文件路径存入result列表
void traverse_dir_win(const std::string& dir_path, std::vector<std::string>& result) {
std::string search_path = dir_path + "\*";
WIN32_FIND_DATAA find_data;
HANDLE h_find = FindFirstFileA(search_path.c_str(), &find_data);
if (h_find == INVALID_HANDLE_VALUE) {
std::cerr << "无法打开目录: " << dir_path << std::endl;
return;
}
do {
// 跳过当前目录和上级目录标识
if (strcmp(find_data.cFileName, ".") == 0 || strcmp(find_data.cFileName, "..") == 0) {
continue;
}
std::string full_path = dir_path + "\" + find_data.cFileName;
// 判断是否为目录，FILE_ATTRIBUTE_DIRECTORY是目录属性标识
if (find_data.dwFileAttributes & FILE_ATTRIBUTE_DIRECTORY) {
// 递归遍历子目录
traverse_dir_win(full_path, result);
} else {
// 普通文件，加入结果列表
result.push_back(full_path);
}
} while (FindNextFileA(h_find, &find_data) != 0);
FindClose(h_find);
}
int main() {
std::string target_dir = "C:\test_dir";
std::vector<std::string> all_files;
traverse_dir_win(target_dir, all_files);
std::cout << "目录下的所有文件：" << std::endl;
for (const auto& file : all_files) {
std::cout << file << std::endl;
}
return 0;
}
实用技巧拓展
过滤特定类型文件
如果只需要获取特定后缀的文件，可以在记录文件路径时增加后缀判断逻辑，比如只获取txt文件：
#include <algorithm>
// 判断文件是否为txt类型
bool is_txt_file(const std::string& file_path) {
if (file_path.size() < 4) return false;
return file_path.substr(file_path.size() - 4) == ".txt";
}
// 在遍历到普通文件时调用判断
if (entry->d_type == DT_DIR) {
traverse_dir(full_path, result);
} else {
if (is_txt_file(full_path)) {
result.push_back(full_path);
}
}
处理隐藏文件
Linux系统下隐藏文件以.开头，Windows系统下隐藏文件有FILE_ATTRIBUTE_HIDDEN属性，可以在遍历时根据需求选择是否跳过隐藏文件。
跨平台实现建议
如果需要编写跨平台的目录遍历代码，可以使用C++17引入的<filesystem>标准库，它提供了统一的目录操作接口，不需要区分不同系统的API，示例代码如下：
#include <iostream>
#include <filesystem>
#include <vector>
namespace fs = std::filesystem;
void traverse_dir_std(const fs::path& dir_path, std::vector<fs::path>& result) {
try {
for (const auto& entry : fs::recursive_directory_iterator(dir_path)) {
// 判断是否为普通文件
if (fs::is_regular_file(entry.status())) {
result.push_back(entry.path());
}
}
} catch (const fs::filesystem_error& e) {
std::cerr << "遍历目录出错: " << e.what() << std::endl;
}
}
int main() {
fs::path target_dir = "./test_dir";
std::vector<fs::path> all_files;
traverse_dir_std(target_dir, all_files);
std::cout << "目录下的所有文件：" << std::endl;
for (const auto& file : all_files) {
std::cout << file.string() << std::endl;
}
return 0;
}
使用C++标准库的<filesystem>可以大幅简化跨平台开发的复杂度，推荐在支持C++17及以上的环境中优先使用这种方式实现目录递归遍历。
C++递归遍历目录获取文件夹所有文件opendirreaddir递归算法修改时间：2026-06-27 20:57:32