0

0

C++怎么遍历文件夹 C++ filesystem库操作目录与文件【C++17】

穿越時空

穿越時空

发布时间:2026-01-28 11:54:11

|

901人浏览过

|

来源于php中文网

原创

应使用 std::filesystem::recursive_directory_iterator 遍历子目录和文件,它自动深度优先遍历并支持跳过权限错误;需处理 filesystem_error 异常或设置 skip_permission_denied 选项。

c++怎么遍历文件夹 c++ filesystem库操作目录与文件【c++17】

怎么用 std::filesystem 遍历子目录和文件

直接用 std::filesystem::recursive_directory_iterator,它会自动进入子目录,按深度优先顺序返回所有 directory_entry。别手写递归——容易漏掉符号链接、权限错误或循环引用。

常见错误是没捕获异常:access_deniednot_a_directory 会抛 std::filesystem::filesystem_error,不处理就 crash。默认构造的迭代器不跳过异常,得手动加 try/catch 或用 std::filesystem::directory_options::skip_permission_denied

  • 用法示例:
    for (auto& entry : std::filesystem::recursive_directory_iterator(path, std::filesystem::directory_options::skip_permission_denied)) {
        if (entry.is_regular_file()) {
            std::cout << entry.path() << "\n";
        }
    }
  • 想只遍历当前层?换用 std::filesystem::directory_iterator,它不进子目录
  • 路径末尾带斜杠不影响,但传入空字符串或非法路径会立即抛异常

std::filesystem::is_directoryis_regular_file 判断不准?

不是函数不准,是调用前没确认 entry 状态是否已缓存。directory_entry 默认惰性加载元数据,首次调用 is_* 才去查系统。如果中间路径被删/权限变,可能抛异常;更糟的是,某些平台(如 Windows)对符号链接默认不解析,is_directory() 返回 false 即使它指向一个目录。

  • 保险做法:先调 entry.status()entry.symlink_status(),再判断类型
  • 区分真实类型和链接目标:用 status() 查链接目标,symlink_status() 查链接本身
  • Windows 下注意:NTFS 重解析点(如 junction)会被 is_directory() 误判,必须用 symlink_status().type() == std::filesystem::file_type::directory

跨平台遍历时路径分隔符和编码问题

std::filesystem::path 内部统一用 / 存储,无论 Windows 还是 Linux,path.native() 才转成本地格式(Windows 上变成 \)。但真正要注意的是字符编码:Windows API 默认用当前代码页(如 GBK),而 C++17 标准要求 std::filesystem 接收 UTF-8 字符串(GCC/Clang)或宽字符(MSVC)。

imgAK AI高清放大器
imgAK AI高清放大器

imgak AI 图片无损高清放大:让模糊图像重获超清生命力

下载

立即学习C++免费学习笔记(深入)”;

  • Linux/macOS:传 UTF-8 std::string 安全
  • MSVC:推荐用 std::wstring 构造 path,否则含中文路径可能失败
  • 避免拼接路径用 +:用 / 操作符,例如 p / "sub" / "file.txt",它自动处理分隔符
  • 打印路径别直接 cout :用 p.string()(UTF-8)或 p.wstring()(宽字符)显式转换

性能差?大量小文件遍历时卡顿

慢通常不是 recursive_directory_iterator 本身的问题,而是每步都触发系统调用查元数据。比如只想要文件名,却反复调 entry.is_regular_file(),等于每个 entry 都 stat 一次。

  • 优化方法:用 entry.file_size() 前先确认类型,或批量用 std::filesystem::status(entry) 一次取回全部信息
  • 不需要递归?改用 directory_iterator + 手动栈管理,避免深度优先的隐式调用开销
  • Windows 上尤其明显:启用“8.3 短文件名”或杀软实时扫描会拖慢 10 倍以上,测试时关掉这些干扰项
  • 别在循环里反复构造 path 对象,复用变量减少临时对象分配

最常被忽略的一点:std::filesystem 在 GCC 需要链接 -lstdc++fs,Clang 要 -lc++fs,MSVC 默认开启但需确保项目设置为 C++17 或更高。忘了加链接选项,编译通过但运行时报 undefined symbol。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

443

2023.08.02

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

298

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

212

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1500

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

623

2023.11.24

java读取文件转成字符串的方法
java读取文件转成字符串的方法

Java8引入了新的文件I/O API,使用java.nio.file.Files类读取文件内容更加方便。对于较旧版本的Java,可以使用java.io.FileReader和java.io.BufferedReader来读取文件。在这些方法中,你需要将文件路径替换为你的实际文件路径,并且可能需要处理可能的IOException异常。想了解更多java的相关内容,可以阅读本专题下面的文章。

613

2024.03.22

php中定义字符串的方式
php中定义字符串的方式

php中定义字符串的方式:单引号;双引号;heredoc语法等等。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

588

2024.04.29

go语言字符串相关教程
go语言字符串相关教程

本专题整合了go语言字符串相关教程,阅读专题下面的文章了解更多详细内容。

170

2025.07.29

php中文乱码如何解决
php中文乱码如何解决

本文整理了php中文乱码如何解决及解决方法,阅读节专题下面的文章了解更多详细内容。

1

2026.01.28

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
SQL 教程
SQL 教程

共61课时 | 3.6万人学习

C# 教程
C# 教程

共94课时 | 7.7万人学习

C 教程
C 教程

共75课时 | 4.2万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号