C++如何获取当前系统的磁盘剩余空间（字节）-C++-PHP中文网

windows下用getdiskfreespaceex获取剩余字节最可靠，需传根路径如"c:"、检查返回值、用large_integer接收避免截断；linux/macos应使用statvfs并乘f_frsize计算字节数。

c++如何获取当前系统的磁盘剩余空间（字节）

Windows 下用 `GetDiskFreeSpaceEx` 获取剩余字节最可靠

直接调用 GetDiskFreeSpaceEx 是 Windows 平台获取磁盘剩余空间（字节级精度）的首选，它返回的是 LARGE_INTEGER，能正确表示大于 4GB 的空闲空间，避免了老式 GetDiskFreeSpace 的 32 位截断问题。

常见错误是传入路径末尾缺少反斜杠或驱动器号格式不对，比如传 "C:" 可能失败，必须用 "C:\"；另外要检查返回值，失败时函数返回 0，且 GetLastError() 可查具体原因（如权限不足、路径不存在）。

示例关键片段：

C++14

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

下载

LARGE_INTEGER freeBytes;
if (GetDiskFreeSpaceEx(L"C:\", nullptr, nullptr, &freeBytes)) {
    uint64_t bytes = freeBytes.QuadPart;
}

路径参数支持 UNC 路径（如 L"\\server\share"），但需确保有访问权限
第三个参数是总空间，第四个才是可用字节数（即用户实际可写入的部分）
注意链接库依赖：需链接 kernel32.lib，Visual Studio 默认已包含

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

statvfs 是 POSIX 标准接口，返回字段单位统一为字节（f_bavail * f_frsize），跨平台兼容性好；而 statfs 在不同系统上 f_bavail 含义不一致（有的是 block 数，有的是字节），容易误算。

典型坑点：忘记乘以 f_frsize 直接用 f_bavail，结果小了 4096 倍（常见块大小）；或者用 f_blocks 算总容量却没考虑 reserved blocks（root 保留空间），导致数值偏高。

示例关键片段：

struct statvfs buf;
if (statvfs("/home", &buf) == 0) {
    uint64_t freeBytes = static_cast<uint64_t>(buf.f_bavail) * buf.f_frsize;
}</uint64_t>

路径只需指定任意一个挂载点目录（如 "/"、"/home"），无需解析到具体设备
f_bavail 是非特权用户可用空闲块数，f_bfree 是所有用户总空闲块数，一般取前者更实用
macOS 上 statvfs 行为与 Linux 一致，无需条件编译

跨平台封装要注意路径处理和类型安全

不能简单 #ifdef 切换，因为 Windows 要求驱动器路径（"C:\"），而 Unix 系统接受任意挂载点（"/"）。若封装成统一接口，建议输入路径做标准化：Windows 下自动补全 "\\"，Unix 下不做改动；同时返回类型必须用 uint64_t，避免 long long 在 Windows MSVC 下与 int64_t 混用引发 ABI 问题。

另一个易忽略点：某些文件系统（如 NFS、FUSE）可能返回 -1 表示“不可信”，此时应设为 0 或抛异常，而不是强制转成大正数。