讲师中心 微信公众号
AI工具推荐 视频效率加速

C++如何获取指定目录下的文件数量(递归)

雨萱酱_7141

雨萱酱_7141

发布时间:2026-07-14 16:03:22

|

372人浏览过

|

来源于php中文网

原创

C++17起应使用std::filesystem::recursive_directory_iterator递归遍历并计数,需启用-std=c++17、包含<filesystem>头文件、捕获filesystem_error异常,并用is_regular_file()筛选文件;Windows/Linux均跨平台支持,自动处理符号链接与权限异常。

c++如何获取指定目录下的文件数量(递归)

std::filesystem::recursive_directory_iterator 遍历目录并计数

从 C++17 开始,std::filesystem 是最直接、跨平台的方案。它能天然处理符号链接、权限拒绝等边界情况,比手写递归或调用系统命令更可靠。

关键点在于:默认构造的 recursive_directory_iterator 会自动进入子目录;需捕获 std::filesystem::filesystem_error,否则遇到无权限目录(如 /proc 下某些条目)会直接抛异常崩溃。

  • 使用 std::distance 要小心——它底层是线性遍历,但无法跳过错误项,仍需手动 try/catch
  • 若只需文件数量(不含目录),检查 iter->is_regular_file();若含目录,用 is_directory() 或直接计数所有 entry
  • Windows 下路径分隔符自动兼容,但注意 \? 前缀不被 std::filesystem 支持,超长路径仍可能失败
#include <filesystem>
#include <iostream>

int count_files_recursive(const std::string& path) {
    int count = 0;
    try {
        for (const auto& entry : std::filesystem::recursive_directory_iterator(path)) {
            if (entry.is_regular_file()) ++count;
        }
    } catch (const std::filesystem::filesystem_error& e) {
        // 忽略无权限目录,或记录日志
        std::cerr << "Skip: " << e.what() << '
';
    }
    return count;
}

Windows API 方式:用 FindFirstFileExW + 手动递归

适用于必须支持 C++14 或更低标准、或需要精细控制(如跳过特定文件名、限制深度)的场景。但代码量大、易出错,且 Windows-only。

核心陷阱是:不能直接对 "C:\dir\*" 递归调用 FindFirstFileExW —— 它只匹配单层;必须先获取子目录列表,再逐个递归调用。

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

C++ 算法竞赛自动化测试数据生成与校验框架
C++ 算法竞赛自动化测试数据生成与校验框架

根据原题生成新题面、验证器及完整测试数据,自动套用 testlib 模板,用于用户要求生成测试数据时。

下载
  • 务必用宽字符版本(FindFirstFileExW),否则中文路径乱码
  • 每次 FindFirstFileExW 后必须配对 FindClose,否则句柄泄漏
  • WIN32_FIND_DATAWcFileName 是文件名,不是完整路径;拼接时注意结尾反斜杠
  • 递归前检查 dwFileAttributes & FILE_ATTRIBUTE_DIRECTORY,且排除 "."".."

Linux/macOS 下用 opendir/readdir 的注意事项

POSIX 方案在非 Windows 平台稳定,但需自己处理符号链接循环、权限错误和内存管理。相比 std::filesystem,它更轻量但更底层。

常见错误是:未检查 readdir 返回 nullptr 就访问结构体字段,或忘记 closedir 导致 fd 耗尽。

  • struct dirent*d_type 字段并非所有文件系统都支持(如某些 NFS),应 fallback 到 stat()
  • 递归前用 realpath() 或哈希记录已访问 inode+device,防止软/硬链接导致无限循环
  • 不要用 scandir() 然后 qsort——除非真需要排序,否则纯浪费 CPU 和内存

性能差异与何时该换方案

单纯统计数量时,std::filesystem::recursive_directory_iterator 在小目录下足够快;但当目录层级深、文件极多(>10 万)时,频繁构造 std::filesystem::path 对象会产生可观开销。

  • 若只需要总数,避免创建每个 path 对象:用 entry.path().c_str() 获取原始字符串,或用 entry.file_size() 前先判断类型
  • 极端性能场景(如备份工具),可考虑 getdents64(Linux)或 fts_open(POSIX),但移植性差、API 复杂
  • 别为“递归”强行用递归——现代文件系统有深度限制(如 ext4 默认 64 层),实际中栈溢出风险远低于权限/符号链接问题

真正难的不是怎么写循环,而是决定要不要进某个子目录:权限拒绝、挂载点、用户指定排除模式……这些逻辑一旦加进去,std::filesystem 的简洁性就迅速瓦解,此时封装成独立函数并明确错误处理策略比追求“一行解决”更重要。

热门AI工具

更多
豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

相关专题

更多
c++和c语言的区别有哪些
c++和c语言的区别有哪些

c++和c语言的区别:1、面向对象编程(OOP)支持不同;2、新增特性不同;3、标准库不同;4、编译方式不同;5、命名空间不同等等。想了解更多c++的相关内容,可以阅读本专题下面的文章。

2068

2024.03.14

c++和python学习顺序推荐
c++和python学习顺序推荐

一般建议先学习C++,再学习Python,因为这样可以逐步从较为底层的编程语言向更高级的语言过渡。想了解更多python的相关内容,可以阅读本专题下面的文章。

959

2024.03.14

python和c++学习性价比分析
python和c++学习性价比分析

Python易于学习,广泛应用于Web开发、数据科学和人工智能等领域,但性能较低。C语言性能高,适用于对性能要求较高的场景,如游戏开发和系统编程,但学习曲线陡峭,错误处理复杂。想了解更多python的相关内容,可以阅读本专题下面的文章。

367

2024.03.14

c语言和c++一样吗
c语言和c++一样吗

c语言和c++是两种不同的编程语言,虽然有相似之处,但存在显著差异。c语言专注于过程式编程和系统级开发,以简洁、高效著称。c++作为c语言的超集,引入了面向对象编程,增强了代码组织和管理能力,但学习曲线也更陡峭。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

307

2024.03.14

c语言和c++先学哪个好
c语言和c++先学哪个好

初学者选择学习c语言还是c++语言,需要根据个人学习目标、背景以及编程兴趣和预期应用方向来决定。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

346

2024.03.14

c语言和c++的区别和联系
c语言和c++的区别和联系

c语言和c++是计算机科学领域应用广泛的编程语言。虽然它们有着相似的基础,但它们在语言类型、语法功能和内存管理方面存在着显著差异。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

560

2024.03.14

c++软件中文更改教程
c++软件中文更改教程

对于 ide,可通过打开设置,找到语言设置,选择中文,并保存更改。对于非 ide 应用程序,可查找设置或选项,选择语言设置,更改为中文,并保存更改。想了解更多c++的相关内容,可以阅读本专题下面的文章。

1389

2024.03.21

python和java和c++学习性价比分析
python和java和c++学习性价比分析

Python以其易学性、丰富的库和活跃的社区而著称,适合数据科学、人工智能和Web开发。Java以其跨平台性、企业级应用开发和Android应用开发而闻名。C++以其底层控制能力、高效性能和游戏开发而著称。选择哪种语言取决于个人兴趣、职业方向和特定需求。想了解更多python和java和c++的相关内容,可以阅读本专题下面的文章。

1177

2024.03.22

Conan私有仓库搭建教程
Conan私有仓库搭建教程

本专题系统的讲解Conan私有仓库的搭建流程,涵盖仓库服务部署、存储目录配置、用户认证、权限划分和远程地址添加,并介绍内部C++依赖包的上传、下载及版本维护方法。

0

2026.09.22

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Conan 2 Essentials 免费课程
Conan 2 Essentials 免费课程

共0课时 | 0人学习

CMake 与 Conan 集成实践
CMake 与 Conan 集成实践

共0课时 | 0人学习

Conan 2 高级依赖模型介绍
Conan 2 高级依赖模型介绍

共0课时 | 0人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn