C++如何遍历文件夹_C++ filesystem库文件路径操作教程

c++kquote>C++17引入std::filesystem库,通过directory_iterator和recursive_directory_iterator可遍历目录与子目录,结合is_regular_file、is_directory等方法区分文件类型,并利用path的成员函数获取路径信息,使文件系统操作更简单安全。

使用C++遍历文件夹在现代C++(C++17及以上)中变得非常简单,这主要得益于 std::filesystem 库的引入。该库提供了跨平台的方式来操作文件系统,包括遍历目录、检查路径类型、获取文件属性等。

启用 filesystem 库

要使用 filesystem,需确保:

  • 编译器支持 C++17 或更高版本
  • 包含头文件 #include
  • 链接必要的库(如 GCC 需要 -lstdc++fs,但新版通常不再需要)
示例编译命令:
g++ -std=c++17 your_file.cpp -o your_program

遍历文件夹的基本方法

使用 std::filesystem::directory_iterator 可以轻松遍历指定目录下的所有条目。

代码示例:遍历目录并打印文件名
#include 
#include 

int main() {
    std::string path = "./test_folder"; // 替换为你的目录路径

    for (const auto &entry : std::filesystem::directory_iterator(path)) {
        std::cout << entry.path() << "\n";
    }

    return 0;
}

这段代码会输出目录中每个文件和子目录的完整路径。

区分文件和目录

你可以通过 is_regular_file()is_directory() 判断条目类型。

示例:分别列出文件和目录
for (const auto &entry : std::filesystem::directory_iterator(path)) {
    if (entry.is_regular_file()) {
        std::cout << "文件: " << entry.path().filename() << "\n";
    } else if (entry.is_directory()) {
        std::cout << "目录: " << entry.path().filename() << "\n";
    }
}

递归遍历子目录

若要进入子目录继续遍历,使用 std::filesystem::recursive_directory_iterator

示例:递归打印所有内容
for (const auto &entry : std::filesystem::recursive_directory_iterator(path)) {
    std::cout << entry.path() << "\n";
}

它会自动深入每一层子目录,直到遍历完整个树形结构。

获取路径信息的常用方法

std::filesystem::path 提供了多种便捷操作:

  • filename():获取文件名(含扩展名)
  • stem():获取文件名主体(不含扩展名)
  • extension():获取扩展名
  • parent_path():获取父目录路径
  • has_extension():判断是否有扩展名
示例用法:
auto p = entry.path();
std::cout << "文件名: " << p.filename() << "\n";
std::cout << "扩展名: " << p.extension() << "\n";
std::cout << "所在目录: " << p.parent_path() << "\n";
基本上就这些。只要开启C++17,filesystem库让文件操作变得直观又安全。