C++如何用std::filesystem遍历目录？C++17文件系统库的使用方法详解

std::filesystem库基础说明

C++17标准中正式将文件系统库纳入标准库范畴，对应的头文件为<filesystem>，所有相关接口都位于std::filesystem命名空间下。在使用前需要确认编译器是否支持C++17及以上标准，编译时需要开启对应的标准选项，比如GCC编译器需要添加-std=c++17参数。

目录遍历主要用到的核心类型有两个：directory_iterator用于非递归遍历单层目录，recursive_directory_iterator用于递归遍历目录下所有子目录的内容。两者都支持迭代器遍历语法，使用方式和标准容器的迭代器类似。

非递归遍历单层目录

如果只需要遍历指定目录下的直接子文件和子目录，不需要进入子目录继续遍历，可以使用directory_iterator实现。下面的示例演示了如何遍历指定路径下的所有条目，并打印每个条目的路径和类型。

#include <iostream>
#include <filesystem>

namespace fs = std::filesystem;

int main() {
    // 要遍历的目标目录路径，这里替换为实际需要遍历的目录
    fs::path target_dir = "./test_dir";
    
    // 检查目标路径是否存在且是目录
    if (!fs::exists(target_dir) || !fs::is_directory(target_dir)) {
        std::cerr << "目标路径不存在或不是目录" << std::endl;
        return 1;
    }
    
    // 使用directory_iterator遍历单层目录
    for (const auto& entry : fs::directory_iterator(target_dir)) {
        // 获取当前条目的路径
        fs::path entry_path = entry.path();
        // 判断当前条目是文件还是目录
        if (fs::is_regular_file(entry_path)) {
            std::cout << "文件: " << entry_path.string() << std::endl;
        } else if (fs::is_directory(entry_path)) {
            std::cout << "目录: " << entry_path.string() << std::endl;
        } else {
            std::cout << "其他类型: " << entry_path.string() << std::endl;
        }
    }
    
    return 0;
}

递归遍历所有子目录

如果需要遍历目标目录下的所有层级子目录，包括子目录中的内容，就需要使用recursive_directory_iterator。该迭代器会自动递归进入所有子目录，不需要开发者手动处理目录层级。

#include <iostream>
#include <filesystem>

namespace fs = std::filesystem;

int main() {
    fs::path target_dir = "./test_dir";
    
    if (!fs::exists(target_dir) || !fs::is_directory(target_dir)) {
        std::cerr << "目标路径不存在或不是目录" << std::endl;
        return 1;
    }
    
    // 使用recursive_directory_iterator递归遍历所有目录
    for (const auto& entry : fs::recursive_directory_iterator(target_dir)) {
        fs::path entry_path = entry.path();
        // 获取当前条目相对于目标目录的相对路径
        fs::path relative_path = fs::relative(entry_path, target_dir);
        
        if (fs::is_regular_file(entry_path)) {
            std::cout << "文件: " << relative_path.string() << std::endl;
        } else if (fs::is_directory(entry_path)) {
            std::cout << "目录: " << relative_path.string() << std::endl;
        }
    }
    
    return 0;
}

遍历过程中的异常处理

目录遍历过程中可能会遇到权限不足、路径非法、目录被删除等异常情况，std::filesystem的接口会抛出filesystem_error异常，因此建议使用try-catch块包裹遍历逻辑，避免程序异常崩溃。

#include <iostream>
#include <filesystem>

namespace fs = std::filesystem;

int main() {
    fs::path target_dir = "./test_dir";
    
    try {
        if (!fs::exists(target_dir)) {
            std::cerr << "目标路径不存在" << std::endl;
            return 1;
        }
        
        for (const auto& entry : fs::recursive_directory_iterator(target_dir)) {
            std::cout << entry.path().string() << std::endl;
        }
    } catch (const fs::filesystem_error& e) {
        // 捕获文件系统相关的异常，打印错误信息
        std::cerr << "遍历目录发生错误: " << e.what() << std::endl;
        return 1;
    } catch (const std::exception& e) {
        // 捕获其他通用异常
        std::cerr << "发生未知错误: " << e.what() << std::endl;
        return 1;
    }
    
    return 0;
}

注意事项

• 路径类型优先使用fs::path，不要直接使用字符串拼接路径，避免不同操作系统的路径分隔符问题，fs::path会自动处理跨平台的路径拼接。
• 如果遍历过程中需要跳过某些特殊目录，比如.git目录，可以在循环中添加判断逻辑，直接continue跳过当前迭代即可。
• 使用recursive_directory_iterator时，如果某个子目录没有访问权限，默认会抛出异常，可以在构造迭代器时传入fs::directory_options::skip_permission_denied选项跳过无权限的目录。
• 遍历获取的文件路径默认是绝对路径，如果需要相对路径可以使用fs::relative函数转换。

std::filesystem遍历目录C++17修改时间：2026-06-27 13:57:36