应使用std::filesystem::recursive_directory_iterator遍历所有regular_file并累加file_size(),跳过目录和符号链接,捕获权限异常,用uintmax_t防溢出,并在unix平台用st_dev/st_ino去重硬链接。

用 std::filesystem::recursive_directory_iterator 遍历目录并累加文件大小
标准库从 C++17 开始提供 std::filesystem,这是最便携、无需第三方依赖的方案。关键不是“统计目录本身”,而是递归遍历所有 regular_file 并累加 file_size()。
常见错误是直接对目录调用 file_size() —— 这会抛出 std::filesystem::filesystem_error,因为目录没有“大小”概念(POSIX/Linux 下目录也是文件,但 C++ 标准明确禁止对非普通文件调用 file_size())。
- 必须跳过
directory_entry中类型为directory或symlink(除非你主动解引用)的条目 - 对每个
regular_file调用file_size(),捕获可能的权限错误(如access_denied)并跳过 - 使用
uintmax_t接收file_size()返回值,避免 32 位整数溢出(单个文件可能 >4GB)
uintmax_t total = 0;
for (const auto& entry : std::filesystem::recursive_directory_iterator(path)) {
if (entry.is_regular_file()) {
try {
total += entry.file_size();
} catch (const std::filesystem::filesystem_error&) {
// 权限不足或路径失效,忽略
}
}
}
Windows 上用 FindFirstFileExW + 手动递归更可控
如果你需要绕过 std::filesystem 的异常开销,或需精确控制符号链接处理(比如是否跟随),Win32 API 是更底层的选择。但要注意:C++ 标准库的 recursive_directory_iterator 在 Windows 上底层也调用类似 API,手动实现只是换种方式暴露细节。
容易踩的坑是没正确处理 FILE_ATTRIBUTE_REPARSE_POINT —— 这类项可能是符号链接或挂载点,盲目递归会导致无限循环或重复计数。
- 用
FindFirstFileExW获取目录内容,逐项判断dwFileAttributes - 跳过
.和..目录项 - 对
FILE_ATTRIBUTE_DIRECTORY且非重解析点的项才递归 - 对
FILE_ATTRIBUTE_NORMAL或FILE_ATTRIBUTE_ARCHIVE的文件调用GetFileSizeEx
Linux/macOS 下避免 stat() 误判硬链接重复计数
Unix-like 系统中,多个硬链接指向同一 inode。若不做去重,同一个物理文件会被多次计入总大小 —— 这明显违背“目录总大小”的语义(用户期望的是磁盘实际占用)。
std::filesystem::directory_entry::inode() 在 POSIX 平台可用(GCC/Clang 支持),但 MSVC 不支持;更便携的方式是用 stat() 提取 st_ino 和 st_dev 组合判重。
- 维护一个
std::set<:pair ino_t>></:pair>记录已统计过的 inode - 每次
stat()后检查(st_dev, st_ino)是否存在,存在则跳过 - 注意:
st_dev必须一起判断,因为不同设备可能有相同ino_t
性能差异:递归 vs 迭代 + 栈模拟
深度嵌套目录下,递归调用容易触发栈溢出(尤其 Debug 模式或栈空间受限环境)。std::filesystem::recursive_directory_iterator 内部用迭代+栈实现,已规避该问题,但自定义遍历时仍需警惕。
- 用
std::stack<:filesystem::path></:filesystem::path>替代函数递归,显式管理待处理路径 - 每次 pop 一个路径,遍历其子项,将子目录 push 入栈
- 避免在循环内频繁构造
std::string路径(用path.append()或/操作符更高效)
真正复杂的地方不在算法逻辑,而在于跨平台行为差异:macOS 对某些系统目录(如 /proc、/sys)返回 0 大小;Linux 下某些虚拟文件系统(/dev)的文件大小无意义;Windows 的压缩文件或稀疏文件,file_size() 返回逻辑大小而非实际磁盘占用 —— 如果你要的是“磁盘占用”,得用 du 类逻辑(即 st_blocks * 512),而非 st_size。
C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!











