statvfs()是最轻量可靠的POSIX接口，用于获取文件系统块级统计：总空间=f_blocks×f_frsize，已用空间=(f_blocks−f_bfree)×f_frsize，用户可用空间=f_bavail×f_frsize；注意f_bavail才反映普通用户实际可写入量，因已扣除root保留块。
Linux 下用 statvfs() 读取文件系统块配额和使用率
直接调用 statvfs() 是最轻量、最可靠的方式，它绕过 shell 工具解析，不依赖 df 命令输出格式变化，且能精确到文件系统挂载点粒度。注意它返回的是「块」（block）级统计，不是字节级——f_frsize 是基本块大小，f_bsize 是 I/O 块大小，计算容量时必须用 f_frsize。
常见错误是把 f_blocks 直接当总字节数：实际总空间 = f_blocks * f_frsize；已用空间 = (f_blocks - f_bfree) * f_frsize；可用空间（非 root 用户）= f_bavail * f_frsize。
示例关键片段：
#include <sys>
struct statvfs fs;
if (statvfs("/home", &fs) == 0) {
uint64_t total = fs.f_blocks * fs.f_frsize;
uint64_t used = (fs.f_blocks - fs.f_bfree) * fs.f_frsize;
double usage_pct = (double)used / total * 100.0;
}
</sys>
为什么 getmntent() + statvfs() 联用比遍历 /proc/mounts 更稳妥
/proc/mounts 是文本文件，字段顺序和空格数量不严格规范，某些容器环境或 overlayfs 挂载可能含特殊字符或换行，正则或 sscanf() 容易崩。而 getmntent() 是 glibc 提供的标准接口，自动处理注释、转义与字段对齐。
实操建议：
- 用
setmntent("/proc/mounts", "r")打开，逐条调用getmntent() - 过滤掉
type为proc、sysfs、devtmpfs等虚拟文件系统 - 对每个
mnt_dir（如"/"、"/home"）调用statvfs()，避免硬编码路径 - 注意
statvfs()在 NFS 或 FUSE 挂载点上可能返回-1并设errno=ENOSYS，需跳过并记录警告
statvfs() 返回的 f_bavail 和 f_bfree 区别在哪
f_bfree 是所有用户（含 root）可见的空闲块数；f_bavail 是普通用户实际可写入的块数——内核会为 root 保留一部分（通常 5%），防止磁盘写满导致系统异常。监控告警必须用 f_bavail，否则会出现「df 显示还有 8% 空间，但应用却报磁盘满」的情况。
典型误用场景：
- 用
(f_blocks - f_bfree)计算“已用”，结果偏高（把 root 保留块也算进已用） - 阈值判断用
f_bfree做分母，导致百分比失真 - 在容器中未检查挂载点是否为
overlay或tmpfs，这些类型f_bavail可能恒为 0 或不可靠
C++ 封装时绕不开的跨平台陷阱
Windows 没有 statvfs()，得用 GetDiskFreeSpaceEx()；macOS 虽支持 statvfs()，但 f_frsize 可能为 0，需 fallback 到 f_bsize。更麻烦的是：Windows 的 ULARGE_INTEGER 是结构体，不能直接 static_cast 到 uint64_t，必须用 .QuadPart 成员。
最小可行封装要点：
- 用
#ifdef __linux__/#ifdef _WIN32分支，别试图写统一接口 - Linux/macOS 下优先取
f_frsize，为 0 时用f_bsize - Windows 下传入
LPCWSTR路径，注意MultiByteToWideChar()转换 UTF-8 路径 - 所有返回值统一为
struct { uint64_t total, used, avail; }，不暴露平台原生类型
真正难的不是获取数据，而是理解「可用空间」在不同上下文中的语义差异：root 权限、配额限制（quota）、项目配额（project quota）、容器 cgroup blkio 限速——这些都得额外查 quotactl() 或 /sys/fs/cgroup/，statvfs() 本身不感知。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
