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

梦枫小哥_4434

梦枫小哥_4434

2026-03-31

473人浏览

原创

c++17起推荐用std::filesystem::recursive_directory_iterator递归遍历,它自动跳过符号链接循环、无需手写递归,但需try-catch捕获filesystem_error,用is_regular_file()过滤文件,并注意编译链接要求。

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

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

C++17 起,std::filesystem 是标准方案,不用依赖 Boost 或系统 API。它天然支持递归遍历,且自动跳过循环符号链接(默认行为),比手写递归或调用 FindFirstFile / opendir 更可靠。

常见错误是误用 directory_iterator(非 recursive 版)——它只扫一层,漏掉子目录里的文件;或者没处理异常,遇到权限不足的目录(如 /proc 下某些条目)直接崩溃。

  • 必须加 #include <filesystem></filesystem>,并链接 -lstdc++fs(GCC 早期版本)或启用 C++17 标准(-std=c++17)
  • 遍历时用 try-catch 包住迭代器递增操作,捕获 std::filesystem::filesystem_error
  • 用 is_regular_file() 过滤,排除目录、socket、设备文件等
int count_files(const std::string& path) {
    int cnt = 0;
    try {
        for (const auto& entry : std::filesystem::recursive_directory_iterator(path)) {
            if (entry.is_regular_file()) ++cnt;
        }
    } catch (const std::filesystem::filesystem_error& e) {
        // 忽略无权限目录,不中断计数
    }
    return cnt;
}

Windows 下用 FindFirstFileExW 需手动递归,容易栈溢出

如果项目不能用 C++17,又必须纯 Win32,就得自己实现递归。但直接深度优先易触发栈溢出(极深目录树),且 FindFirstFile 不区分文件/目录,得靠 FILE_ATTRIBUTE_DIRECTORY 判断。

关键陷阱是:忽略 FILE_ATTRIBUTE_REPARSE_POINT 可能陷入符号链接死循环;不跳过 "." 和 ".." 会导致重复计数甚至无限递归。

  • 必须检查 dwFileAttributes 中是否含 FILE_ATTRIBUTE_DIRECTORY
  • 对每个子目录调用前,先用 PathIsDirectoryEmptyW 或手动判断是否为 "."/".."
  • 建议改用 BFS(队列)替代 DFS,避免栈爆炸;或限制最大递归深度(比如 64 层)

Linux/macOS 用 opendir + readdir 时注意 DT_REG 和编码

readdir 返回的 d_type 字段不是所有文件系统都支持,某些 NFS 或旧 ext3 卷可能返回 DT_UNKNOWN,这时必须调用 stat() 补判,带来额外 syscall 开销。

C++14
C++14

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

下载

另一个坑是路径编码:如果目录名含非 UTF-8 字节(比如某些遗留 FAT32 卷),readdir 返回的 d_name 是原始字节流,直接拼接路径再 stat 可能失败,但计数逻辑本身不受影响(只要不 crash)。

  • 优先用 d_type == DT_REG 快速过滤;若为 DT_UNKNOWN,再 stat 确认
  • 跳过 "." 和 ".." —— 这俩在 readdir 结果里一定存在,不跳会无限递归
  • 递归调用前,确保路径末尾有 /,避免 "/home/user" + "subdir" 拼成 "/home/usersubdir"

性能差异:小目录无所谓,大目录下 recursive_directory_iterator 更稳

实测百万级文件时,std::filesystem::recursive_directory_iterator 在 GCC 12/Clang 14 下比手写 opendir 快约 10–15%,主因是内部做了路径缓存和批量 stat 优化;而 Win32 的 FindFirstFileExW 在 NTFS 上表现接近,但遇到大量稀疏目录(每层几百个子目录)时,手写 BFS 队列比 DFS 更省内存。

真正卡顿点往往不在遍历本身,而在 stat() 或等价的元数据读取 —— 如果你只需要“数量”,就别调 entry.file_size() 或 last_write_time(),它们会触发额外 IO。

  • 确认只计数?那就只调 is_regular_file(),别碰其他属性函数
  • SSD 上差别不大,但机械盘 + 深目录结构下,减少 stat 调用次数能明显提速
  • macOS 的 fts_open 虽快,但已标记为 legacy,且不跨平台,不推荐新项目用

递归深度控制、权限异常处理、符号链接防环,这三处漏掉任一个,程序在真实环境跑几小时后大概率挂掉——不是功能错,是根本走不完。

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

相关文章

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

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

下载

相关标签:

c++

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

相关专题

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

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

2023.07.18

5607

5

堆和栈区别
堆和栈区别

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

2023.08.10

2428

6

windows查看端口占用情况
windows查看端口占用情况

Windows端口可以认为是计算机与外界通讯交流的出入口。逻辑意义上的端口一般是指TCP/IP协议中的端口,端口号的范围从0到65535,比如用于浏览网页服务的80端口,用于FTP服务的21端口等等。怎么查看windows端口占用情况呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.26

3199

3

查看端口占用情况windows
查看端口占用情况windows

端口占用是指与端口关联的软件占用端口而使得其他应用程序无法使用这些端口,端口占用问题是计算机系统编程领域的一个常见问题,端口占用的根本原因可能是操作系统的一些错误,服务器也可能会出现端口占用问题。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.07.27

2778

6

windows照片无法显示
windows照片无法显示

当我们尝试打开一张图片时,可能会出现一个错误提示,提示说"Windows照片查看器无法显示此图片,因为计算机上的可用内存不足",本专题为大家提供windows照片无法显示相关的文章,帮助大家解决该问题。

2023.08.01

1488

3

windows查看端口被占用的情况
windows查看端口被占用的情况

windows查看端口被占用的情况的方法:1、使用Windows自带的资源监视器;2、使用命令提示符查看端口信息;3、使用任务管理器查看占用端口的进程。本专题为大家提供windows查看端口被占用的情况的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

2539

5

windows无法访问共享电脑
windows无法访问共享电脑

在现代社会中,共享电脑是办公室和家庭的重要组成部分。然而,有时我们可能会遇到Windows无法访问共享电脑的问题。这个问题可能会导致数据无法共享,影响工作和生活的正常进行。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.08

3270

4

windows自动更新
windows自动更新

Windows操作系统的自动更新功能可以确保系统及时获取最新的补丁和安全更新,以提高系统的稳定性和安全性。然而,有时候我们可能希望暂时或永久地关闭Windows的自动更新功能。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.10

1597

3

windows boot manager
windows boot manager

windows boot manager无法开机的解决方法:1、系统文件损坏,使用Windows安装光盘或USB启动盘进入恢复环境,选择修复计算机,然后选择自动修复;2、引导顺序错误,进入恢复环境,选择命令提示符,输入命令"bootrec /fixboot"和"bootrec /fixmbr",然后重新启动计算机;3、硬件问题,使用硬盘检测工具进行扫描和修复;4、重装操作系统。本专题还提供其他解决

2023.08.28

2477

4

热门下载

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

精品课程

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

共0课时 | 0人学习

C++ Reference
C++ Reference

共0课时 | 0人学习

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

共0课时 | 0人学习