c++怎么获取文件系统的总容量、剩余容量及可用空间信息【详解】-C++-PHP中文网

Windows 用 GetDiskFreeSpaceEx 获取磁盘空间最直接，需传根路径、检查返回值，注意 *lpFreeBytesAvailable 是当前用户可用空间；Linux/macOS 应用 statvfs，乘 f_frsize 得字节数，f_bavail 为非特权用户可用空间，且须解析挂载点而非符号链接。

c++怎么获取文件系统的总容量、剩余容量及可用空间信息【详解】

Windows 下用 `GetDiskFreeSpaceEx` 获取磁盘空间最直接

Windows 原生 API 提供了最轻量、最可靠的方式，不需要额外依赖或权限提升。它返回的是真实可用空间（考虑配额、管理员保留等），不是简单“剩余减去已用”的算术结果。

常见错误是传入错误路径（比如带尾部反斜杠的 "C:\" 会被拒绝）、忽略返回值检查、或误把 *lpFreeBytesAvailable 当成“剩余容量”——其实它是“当前用户可用空间”，可能小于总剩余（如启用了磁盘配额）。

GetDiskFreeSpaceEx 第二个参数是 *lpFreeBytesAvailable，即当前用户能写的字节数，不是“剩余总量”
第三个参数 *lpTotalNumberOfBytes 是总容量，第四个 *lpTotalNumberOfFreeBytes 是未分配 + 已分配但未使用的字节（即“系统级剩余”）
路径必须是根目录格式，如 "C:\" 或 "\\server\share\"；传 "C:\temp" 会失败并返回 0

示例调用：

LARGE_INTEGER total, free, user_avail;
BOOL ok = GetDiskFreeSpaceEx(L"C:\", &user_avail, &total, &free);
if (!ok) { /* 检查 GetLastError() */ }

Linux/macOS 用 `statvfs` 而不是 `statfs`

statvfs 是 POSIX 标准接口，跨平台兼容性好，返回字段语义清晰；statfs 各系统实现差异大（比如 f_frsize 含义不一致），容易在 macOS 和 Linux 间出错。

关键陷阱是单位混淆：所有大小字段都是“块数”，需乘以 f_frsize（非 f_bsize）才得字节数；f_bavail 才是“非特权用户可用块数”，而 f_bfree 是系统级剩余块数。

路径可以是任意文件或目录（自动定位到所在挂载点），无需是根路径
务必检查返回值：失败时 statvfs 返回 -1，且 errno 可能为 ENOTCONN（NFS 断连）或 ESTALE（挂载失效）

示例计算：

struct statvfs buf;
if (statvfs("/home", &buf) == 0) {
    uint64_t total = buf.f_frsize * buf.f_blocks;
    uint64_t avail = buf.f_frsize * buf.f_bavail; // 用户可用
}

C++ 跨平台封装要注意挂载点识别和符号链接处理

直接对任意路径调用 statvfs 或 GetDiskFreeSpaceEx 不行——如果路径是符号链接或 bind mount，你拿到的是目标设备的空间，不是“看起来所在位置”的设备。必须先解析到真实挂载点。

C++14

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

下载

Linux/macOS 需用 stat + /proc/mounts 或 getmntent 查挂载表；Windows 则要用 GetVolumePathName 把路径转为卷名（如 C:\），再调用 GetDiskFreeSpaceEx。

不要用 realpath 解析符号链接后直接传给 statvfs：它可能跨设备，得到的是链接目标所在磁盘数据，而非原始路径所在磁盘
Windows 上 GetVolumePathName 对网络路径（\servershare）也有效，但要求路径存在且可访问
一个典型坑：/tmp 在某些系统是 tmpfs，statvfs 返回的 f_blocks 是内存限制，不是磁盘容量

注意 `f_bavail` 和 `f_bfree` 的实际差异远大于文档描述

很多文档说“f_bavail 是预留 5% 给 root 的剩余”，但实际行为更复杂：ext4 默认保留 5%，但 XFS 没有硬编码保留；Btrfs 甚至按子卷配额动态计算。更关键的是，f_bavail 还受文件系统当前碎片、inode 可用数、以及是否启用 project quota 影响。

如果你的应用需要精确判断“还能不能写入一个大文件”，只看 f_bavail 不够——必须结合 f_files/f_favail（inode 剩余）和 f_flag & ST_RDONLY（是否只读）一起判断。