c++17起应使用std::filesystem::recursive_directory_iterator递归遍历并计数，需启用-std=c++17、包含头文件、捕获filesystem_error异常，并用is_regular_file()筛选文件；windows/linux均跨平台支持，自动处理符号链接与权限异常。
用 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
<h3>Windows API 方式：用 <code>FindFirstFileExW</code> + 手动递归</h3>
<p>适用于必须支持 C++14 或更低标准、或需要精细控制（如跳过特定文件名、限制深度）的场景。但代码量大、易出错，且 Windows-only。</p>
<p>核心陷阱是：不能直接对 <code>"C:dir*"</code> 递归调用 <code>FindFirstFileExW</code> —— 它只匹配单层；必须先获取子目录列表，再逐个递归调用。</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill4025" title="C++ 算法竞赛自动化测试数据生成与校验框架"><img
src="https://img.php.cn/upload/skill/000/000/081/178988956499722.jpg" alt="C++ 算法竞赛自动化测试数据生成与校验框架" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/skill4025" title="C++ 算法竞赛自动化测试数据生成与校验框架" class="overflowclass">C++ 算法竞赛自动化测试数据生成与校验框架</a>
<p class="overflowclass">根据原题生成新题面、验证器及完整测试数据，自动套用 testlib 模板，用于用户要求生成测试数据时。</p>
</div>
<a rel="nofollow" href="/xiazai/skill4025" title="C++ 算法竞赛自动化测试数据生成与校验框架" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div>
<ul>
<li>务必用宽字符版本（<code>FindFirstFileExW</code>），否则中文路径乱码</li>
<li>每次 <code>FindFirstFileExW</code> 后必须配对 <code>FindClose</code>，否则句柄泄漏</li>
<li>
<code>WIN32_FIND_DATAW</code> 中 <code>cFileName</code> 是文件名，不是完整路径；拼接时注意结尾反斜杠</li>
<li>递归前检查 <code>dwFileAttributes & FILE_ATTRIBUTE_DIRECTORY</code>，且排除 <code>"."</code> 和 <code>".."</code>
</li>
</ul>
<h3>Linux/macOS 下用 <code>opendir</code>/<code>readdir</code> 的注意事项</h3>
<p>POSIX 方案在非 Windows 平台稳定，但需自己处理符号链接循环、权限错误和内存管理。相比 <code>std::filesystem</code>，它更轻量但更底层。</p>
<p>常见错误是：未检查 <code>readdir</code> 返回 <code>nullptr</code> 就访问结构体字段，或忘记 <code>closedir</code> 导致 fd 耗尽。</p>
<ul>
<li>
<code>struct dirent*</code> 的 <code>d_type</code> 字段并非所有文件系统都支持（如某些 NFS），应 fallback 到 <code>stat()</code>
</li>
<li>递归前用 <code>realpath()</code> 或哈希记录已访问 inode+device，防止软/硬链接导致无限循环</li>
<li>不要用 <code>scandir()</code> 然后 <code>qsort</code>——除非真需要排序，否则纯浪费 CPU 和内存</li>
</ul>
<h3>性能差异与何时该换方案</h3>
<p>单纯统计数量时，<code>std::filesystem::recursive_directory_iterator</code> 在小目录下足够快；但当目录层级深、文件极多（>10 万）时，频繁构造 <code>std::filesystem::path</code> 对象会产生可观开销。</p>
<ul>
<li>若只需要总数，避免创建每个 <code>path</code> 对象：用 <code>entry.path().c_str()</code> 获取原始字符串，或用 <code>entry.file_size()</code> 前先判断类型</li>
<li>极端性能场景（如备份工具），可考虑 <code>getdents64</code>（Linux）或 <code>fts_open</code>（POSIX），但移植性差、API 复杂</li>
<li>别为“递归”强行用递归——现代文件系统有深度限制（如 ext4 默认 64 层），实际中栈溢出风险远低于权限/符号链接问题</li>
</ul>
<p>真正难的不是怎么写循环，而是决定要不要进某个子目录：权限拒绝、挂载点、用户指定排除模式……这些逻辑一旦加进去，<code>std::filesystem</code> 的简洁性就迅速瓦解，此时封装成独立函数并明确错误处理策略比追求“一行解决”更重要。</p></iostream></filesystem>C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
