c++如何获取文件夹占用的空间大小_递归计算目录容量【详解】
C++17可用std::filesystem递归遍历目录并累加file_size()，需捕获异常跳过不可读文件。Windows下使用FindFirstFileExW手动递归，注意路径长度与宽字符。Linux/macOS结合opendir与lstat()，避免符号链接和硬链接重复统计。核心是区分逻辑字节数与物理磁盘占用，前者直接累加即可。
先说几个核心判断。计算文件夹大小，如果用C++17，那 std::filesystem 就是最趁手的工具；如果项目古老，在Windows上得用 FindFirstFileEx 自己折腾，Linux/macOS则离不开 stat() 和 opendir() 的组合拳。但无论哪种方式，真正的难点从来不是遍历本身，而是对边界情况的处理和对“大小”这个概念的界定。
用 std::filesystem::recursive_directory_iterator 遍历目录并累加文件大小
自C++17起，标准库自带的 std::filesystem 是跨平台获取目录容量的不二之选。关键不在于“如何统计子目录个数”，而在于对每个 std::filesystem::directory_entry 判断是否为常规文件，并调用 file_size() 获取字节数。
但这里有个常见的坑：忽略异常。某些文件可能因为权限不足或路径被占用而抛出 std::filesystem::filesystem_error，不捕获的话，程序直接崩溃给你看。
- 必须用
try/catch包裹file_size()调用，跳过那些不可读的项。 - 避免重复计算符号链接指向的目标。好在默认情况下，
recursive_directory_iterator不会解引用符号链接。 - 记住，
is_regular_file()对于符号链接、目录、socket 等都会返回false，只累加它返回true的条目。
uint64_t get_directory_size(const std::filesystem::path& p) {
uint64_t total = 0;
for (const auto& entry : std::filesystem::recursive_directory_iterator(p)) {
try {
if (entry.is_regular_file()) {
total += entry.file_size();
}
} catch (const std::filesystem::filesystem_error&) {
// 忽略权限不足、路径失效等错误
continue;
}
}
return total;
}
Windows 下用 FindFirstFileExW + 手动递归的兼容性陷阱
如果项目必须支持C++14，或者因为某些嵌入式STL实现而禁用了 std::filesystem，那么Windows原生API是可行的替代方案。但要注意，FindFirstFileExW 默认不进入子目录，你必须手动递归调用，这很容易导致栈溢出或路径拼接出错。
典型问题包括：MAX_PATH 限制（260字符）、长路径未启用Unicode支持、WIN32_FIND_DATAW 中 nFileSizeHigh 和 nFileSizeLow 需要组合成64位整数。
- 必须在工程中定义
UNICODE和_UNICODE，否则宽字符API不可用。 - 路径拼接建议用
std::wstring配合std::filesystem::path::generic_wstring()。即使不使用整个filesystem模块，也可以借用其强大的路径处理能力。 - 如果递归深度较大，建议改用栈模拟（
std::stack），避免函数调用栈爆炸。
Linux/macOS 下 stat() 和 opendir() 组合的注意事项
在POSIX环境下，无法用一个系统调用就拿到整个目录的大小。标准流程是：opendir() → 遍历 readdir() → 对每个条目调用 stat() 判断类型和大小。这里最容易踩的坑是符号链接和硬链接的处理。
stat() 默认会跟随符号链接。如果你想跳过链接本身（不计入目标文件），应该改用 lstat()。而硬链接会被多次统计（不同路径指向同一个inode），如果需要去重，得用 st_dev 和 st_ino 缓存已经见过的inode。但通常来说，我们计算“磁盘占用”指的是实际写入的块数，硬链接不应该去重。
- 务必检查
dirent::d_type（如果可用），用它来代替反复调用lstat()，能显著提升性能。 st_size对目录来说恒为0，必须依赖S_ISREG()宏来判断是否为常规文件。- 某些文件系统（如ext4加密目录）可能对非属主返回
-1的st_size，所以需要检查stat()的返回值是否为0。
为什么不能只靠 du -sh 的输出做精度对比？
终端命令 du 默认按文件系统块大小（如4KiB）向上取整统计，而 std::filesystem::file_size() 返回的是逻辑字节数。两者数值天然不一致，尤其是对于小文件多的目录，差异可能达到数倍。
举个例子：一个1字节的文件，在4KiB块大小的文件系统上，物理上占用4096字节空间。du 会报4K，而 file_size() 返回1。如果你的需求是“用户感知的文件体积总和”，用 file_size()；如果是“真实磁盘占用”，则需要结合 statfs()（Linux）或 GetDiskFreeSpaceEx()（Windows）换算块用量。但后者无法精确到单个目录，只能估算。
所以说，真正难的不是遍历，而是明确你到底要的是“逻辑大小”还是“物理占用”。在绝大多数场景下，用户问“这个文件夹多大”，指的就是前者。直接累加 file_size() 就足够了，别被 du 的结果带偏了方向。
Photoshop 2026 是 Adobe 推出的专业图像处理与视觉设计软件，支持 Windows、macOS 和 iPad 等平台，广泛应用于摄影修图、电商设计、平面海报、数字绘画及视觉合成等创作场景。
Blender 是一款免费开源、跨平台的专业 3D 创作软件，集建模、动画、渲染、视频编辑与视觉合成等功能于一体，广泛应用于影视动画、游戏设计和建筑可视化等领域。软件支持 Cycles 物理渲染器与 Eevee 实时渲染引擎，并提供多边形建模、骨骼绑定、物理模拟等专业工具。Blender 兼容 Windows、macOS 和 Linux 系统，安装包轻巧、运行流畅，依托活跃的全球开发者社区持续更新，是从初学者到专业创作者都值得选择的正版 3D 创作工具。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。
Mountain Duck 是一款能将多个网盘挂载到本地的工具，像本地磁盘一样使用网盘。清理链路的完整性会更好一些，做应用卸载、残留处理和空间整理时，通常能少走很多手动排查步骤。
Photoshop 2026 是 Adobe 推出的专业图像处理与视觉设计软件，支持 Windows、macOS 和 iPad 等平台，广泛应用于摄影修图、电商设计、平面海报、数字绘画及视觉合成等创作场景。
Blender 是一款免费开源、跨平台的专业 3D 创作软件，集建模、动画、渲染、视频编辑与视觉合成等功能于一体，广泛应用于影视动画、游戏设计和建筑可视化等领域。软件支持 Cycles 物理渲染器与 Eevee 实时渲染引擎，并提供多边形建模、骨骼绑定、物理模拟等专业工具。Blender 兼容 Windows、macOS 和 Linux 系统，安装包轻巧、运行流畅，依托活跃的全球开发者社区持续更新，是从初学者到专业创作者都值得选择的正版 3D 创作工具。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
Wise Folder Hider Pro 是一款专业级文件和文件夹隐藏加密软件，为私密数据添加多重保护。高频操作更强调就近处理，浏览、整理和跨目录移动文件时，来回切换和重复点击都会少很多。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。