c++ 如何遍历文件夹下的所有文件_c++文件系统遍历与路径操作方法

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

在 C++ 中遍历文件夹下的所有文件,可以使用多种方法。从 C++17 开始,标准库引入了 头文件,极大简化了文件系统操作。对于旧版本的 C++,也可以借助操作系统相关的 API 或第三方库实现。

使用 C++17 filesystem 遍历目录

C++17 提供的 std::filesystem 是最推荐的方式,跨平台且语法简洁。

要遍历某个目录下的所有文件(包括子目录),可以使用 std::filesystem::recursive_directory_iterator;如果只遍历当前目录,使用 std::filesystem::directory_iterator

示例代码:

#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,清晰、安全、可移植。路径操作时注意斜杠方向和权限问题,递归遍历时避免符号链接导致无限循环。不复杂但容易忽略细节。