c++怎么获取文件夹中所有文件的总数量(递归包含子目录)【详解】

老丽吖_9388

老丽吖_9388

2026-03-26

331人浏览

原创

c++17 的 std::filesystem::recursive_directory_iterator 是遍历目录树的标准方案,需启用 -std=c++17、包含头文件、捕获 filesystem_error,并注意符号链接默认不跟随;替代方案如 win32 api 或 posix opendir 需手动处理路径、编码、递归及错误,且易出错。

c++怎么获取文件夹中所有文件的总数量(递归包含子目录)【详解】

用 std::filesystem::recursive_directory_iterator 遍历最直接

这是 C++17 引入的标准方案,不用依赖第三方库,也不用手动处理路径拼接或符号链接循环。只要编译器支持 C++17(GCC 8+、Clang 7+、MSVC 2017 15.7+),就能开箱即用。

常见错误是误用 std::filesystem::directory_iterator —— 它只遍历一级,漏掉所有子目录;还有人试图用 std::filesystem::is_regular_file() 判断时没加异常处理,遇到权限不足的目录直接崩溃。

  • 必须在编译时启用 C++17:加 -std=c++17(GCC/Clang)或 /std:c++17(MSVC)
  • 记得 #include <filesystem></filesystem>,MSVC 还需链接 shlwapi.lib(VS2019 起通常自动)
  • 用 try-catch 包住迭代过程,跳过无权限访问的子目录(std::filesystem::filesystem_error)
  • recursive_directory_iterator 默认会跳过符号链接指向的目录(避免循环),如需跟随,得传 std::filesystem::directory_options::follow_directory_symlink
#include <filesystem>
#include <iostream>

int count_files(const std::filesystem::path& p) {
    int n = 0;
    try {
        for (const auto& entry : std::filesystem::recursive_directory_iterator(p)) {
            if (entry.is_regular_file()) ++n;
        }
    } catch (const std::filesystem::filesystem_error&) {
        // 忽略无法访问的子目录,不中断计数
    }
    return n;
}</iostream></filesystem>

Windows 下用 FindFirstFileExW + 手动递归更轻量但易出错

如果你不能用 C++17,或者对启动速度极度敏感(比如嵌入式或高频调用场景),原生 Win32 API 确实更快,但代价是路径处理、编码、递归栈管理全得自己控。

典型翻车点:宽字符路径没用 std::wstring 存,FindFirstFileExW 返回的 WIN32_FIND_DATAW 中文件名是 UTF-16,混用 char* 直接乱码;还有人忘了在递归前检查 dwFileAttributes & FILE_ATTRIBUTE_DIRECTORY,把 . 和 .. 当成真实子目录反复钻进去。

  • 必须用 FindFirstFileExW(不是 FindFirstFileA),路径参数传 std::wstring
  • 每次进入子目录前,过滤掉 L"." 和 L".." ,否则无限递归
  • 递归调用前要确保子路径长度不超过 MAX_PATH(除非启用长路径支持,且系统已配置 LongPathsEnabled=1)
  • 别忘了 FindClose,否则句柄泄漏

Linux/macOS 下 opendir/readdir 需手动处理符号链接和深度限制

POSIX 方案兼容性最好,连老版本 GCC 都能跑,但标准库不提供递归封装,你得自己写栈或队列模拟遍历,还要决定是否允许软链循环。

C++14
C++14

C++14 对 C++11 的修正与增强版本,适合旧系统维护和较老工具链兼容。

下载

最容易被忽略的是:默认 readdir 不区分文件类型,stat() 每次调用都有 syscall 开销;而如果跳过 stat 直接靠名字判断(比如后缀为 .txt),就会漏掉无扩展名的脚本、二进制文件等。

  • 用 struct dirent::d_type 字段可免一次 stat(glibc 支持,但某些文件系统可能返回 DT_UNKNOWN)
  • 递归深度建议设上限(比如 64 层),防止恶意构造的符号链导致栈溢出
  • opendir 失败时检查 errno == EACCES,跳过而非中止
  • 注意 readdir 不是线程安全的,多线程调用需加锁或改用 readdir_r(已废弃,但部分旧环境仍需)

性能差异主要来自路径解析和系统调用频次

std::filesystem::recursive_directory_iterator 在底层仍会触发大量 stat 或 GetFileAttributesEx,但它做了缓存和批处理优化;手写 POSIX/Win32 实现如果每项都调一次 stat,实际耗时可能翻倍。

真正影响大文件夹统计速度的,往往不是算法,而是磁盘 I/O 模式:顺序读取目录项快,随机跳转查属性慢。所以别在循环里反复拼接完整路径再 stat,尽量复用 dirent 或 WIN32_FIND_DATA 中已有字段。

  • Linux 上用 getdents64(非标准但高效)可绕过 glibc 封装,但丧失可移植性
  • Windows 上开启 FILE_FLAG_BACKUP_SEMANTICS 可提升对大量小文件的遍历速度(需管理员权限)
  • 如果只是粗略估算,可跳过 is_regular_file(),只统计非目录项(但会把 FIFO、socket、设备文件也计入)

递归深度大、权限碎片化、符号链接环——这三类情况,任何方案都要主动防御,不能指望“理论上正确”就不出问题。

C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!

相关文章

c++速学教程(入门到精通)
c++速学教程(入门到精通)

c++怎么学习?c++怎么入门?c++在哪学?c++怎么学才快?不用担心,这里为大家提供了c++速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

c++

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
堆和栈的区别
堆和栈的区别

堆和栈的区别:1、内存分配方式不同;2、大小不同;3、数据访问方式不同;4、数据的生命周期。本专题为大家提供堆和栈的区别的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.18

5747

5

堆和栈区别
堆和栈区别

堆(Heap)和栈(Stack)是计算机中两种常见的内存分配机制。它们在内存管理的方式、分配方式以及使用场景上有很大的区别。本文将详细介绍堆和栈的特点、区别以及各自的使用场景。php中文网给大家带来了相关的教程以及文章欢迎大家前来学习阅读。

2023.08.10

2468

6

线程和进程的区别
线程和进程的区别

线程和进程的区别:线程是进程的一部分,用于实现并发和并行操作,而线程共享进程的资源,通信更方便快捷,切换开销较小。本专题为大家提供线程和进程区别相关的各种文章、以及下载和课程。

2023.08.10

4158

6

Python 多线程与异步编程实战
Python 多线程与异步编程实战

本专题系统讲解 Python 多线程与异步编程的核心概念与实战技巧,包括 threading 模块基础、线程同步机制、GIL 原理、asyncio 异步任务管理、协程与事件循环、任务调度与异常处理。通过实战示例,帮助学习者掌握 如何构建高性能、多任务并发的 Python 应用。

2025.12.24

1169

20

java多线程相关教程合集
java多线程相关教程合集

本专题整合了java多线程相关教程,阅读专题下面的文章了解更多详细内容。

2026.01.21

383

30

C++多线程相关合集
C++多线程相关合集

本专题整合了C++多线程相关教程,阅读专题下面的的文章了解更多详细内容。

2026.01.21

559

24

C# 多线程与异步编程
C# 多线程与异步编程

本专题深入讲解 C# 中多线程与异步编程的核心概念与实战技巧,包括线程池管理、Task 类的使用、async/await 异步编程模式、并发控制与线程同步、死锁与竞态条件的解决方案。通过实际项目,帮助开发者掌握 如何在 C# 中构建高并发、低延迟的异步系统,提升应用性能和响应速度。

2026.02.06

389

20

C++多线程并发控制与线程安全设计实践
C++多线程并发控制与线程安全设计实践

本专题围绕 C++ 在高性能系统开发中的并发控制技术展开,系统讲解多线程编程模型与线程安全设计方法。内容包括互斥锁、读写锁、条件变量、原子操作以及线程池实现机制,同时结合实际案例分析并发竞争、死锁避免与性能优化策略。通过实践讲解,帮助开发者掌握构建稳定高效并发系统的关键技术。

2026.03.16

233

22

Java 多线程与并发编程实战
Java 多线程与并发编程实战

深入讲解 Java 并发编程体系,涵盖 Thread / Runnable / Callable 线程创建方式、线程生命周期与状态转换、synchronized 同步锁与 Lock/ReentrantLock 显式锁、volatile 可见性保证、ThreadPool 线程池配置与调优(核心参数/拒绝策略)、JUC 并发工具类(CountDownLatch/CyclicBarrier/Semaphore/ConcurrentHashMa

2026.04.17

349

31

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C++ Core Guidelines
C++ Core Guidelines

共0课时 | 0人学习

C++ Reference
C++ Reference

共0课时 | 0人学习

C++ 官方标准说明
C++ 官方标准说明

共0课时 | 0人学习