C++如何遍历目录下的所有文件

在C++17标准之前，遍历目录下的所有文件通常需要依赖操作系统提供的API，比如Windows的FindFirstFile、Linux的opendir等，不同平台的代码差异较大，可移植性差。C++17引入的filesystem标准库统一了文件操作的接口，其中recursive_directory_iterator可以递归遍历目录下的所有文件和子目录，大大简化了目录遍历的实现。

recursive_directory_iterator基础用法

recursive_directory_iterator是filesystem库中的一个输入迭代器，它会递归遍历指定路径下的所有文件和子目录。使用时需要包含<filesystem>头文件，并且注意命名空间的引用。

下面是一个最基础的遍历示例，会输出指定目录下所有文件和子目录的路径：

#include <iostream>
#include <filesystem>

// 引入filesystem命名空间，避免每次写std::filesystem
namespace fs = std::filesystem;

int main() {
    // 要遍历的目标目录路径，这里可以替换成实际的目录
    fs::path target_dir = "./test_dir";
    
    try {
        // 创建递归目录迭代器
        fs::recursive_directory_iterator iter(target_dir);
        // 结束迭代器
        fs::recursive_directory_iterator end_iter;
        
        // 遍历所有条目
        for (; iter != end_iter; ++iter) {
            // 输出当前条目的路径
            std::cout << iter->path().string() << std::endl;
        }
    } catch (const fs::filesystem_error& e) {
        // 捕获遍历过程中的异常，比如目录不存在
        std::cerr << "遍历目录出错: " << e.what() << std::endl;
    }
    
    return 0;
}

过滤特定类型的文件

实际开发中我们往往只需要遍历特定后缀的文件，比如只遍历txt文件或者cpp文件，这时候可以结合文件的后缀判断来实现过滤。

下面的示例会遍历目录下所有的cpp文件，并输出它们的路径：

#include <iostream>
#include <filesystem>
#include <string>

namespace fs = std::filesystem;

int main() {
    fs::path target_dir = "./src";
    
    try {
        for (const auto& entry : fs::recursive_directory_iterator(target_dir)) {
            // 判断当前条目是否是普通文件
            if (fs::is_regular_file(entry.status())) {
                // 获取文件名的字符串形式
                std::string file_name = entry.path().filename().string();
                // 判断文件名是否以.cpp结尾
                if (file_name.size() > 4 && file_name.substr(file_name.size() - 4) == ".cpp") {
                    std::cout << "找到cpp文件: " << entry.path().string() << std::endl;
                }
            }
        }
    } catch (const fs::filesystem_error& e) {
        std::cerr << "遍历出错: " << e.what() << std::endl;
    }
    
    return 0;
}

常用操作说明

使用recursive_directory_iterator时，有几个常用的接口需要了解：

• path()：返回当前迭代条目对应的路径对象，可以调用string()方法转为字符串，或者进一步获取文件名、父目录等信息。
• status()：返回当前条目的文件状态，可以结合fs::is_regular_file、fs::is_directory等函数判断条目是普通文件还是目录。
• disable_recursion_pending()：如果当前条目是目录，调用该方法可以跳过该目录的递归遍历，只处理当前目录下的直接条目。

注意事项

在使用recursive_directory_iterator时需要注意以下几点：

1. 编译时需要开启C++17及以上标准，比如GCC编译时添加-std=c++17参数，MSVC需要设置C++语言标准为C++17。

2. 遍历不存在的目录或者没有权限访问的目录时，会抛出fs::filesystem_error异常，因此建议用try-catch块包裹遍历逻辑。

3. 迭代器遍历的顺序是不确定的，不要依赖遍历的顺序来处理业务逻辑。

如果需要非递归的遍历，只遍历当前目录下的直接条目，不需要处理子目录，可以使用directory_iterator替代recursive_directory_iterator，两者的用法基本一致，只是不会递归进入子目录。

C++filesystemrecursive_directory_iterator目录遍历修改时间：2026-07-15 18:42:24