statvfs()仅获取文件系统级块统计，非用户配额；正确计算总空间用f_blocks×f_frsize，用户可用空间用f_bavail×f_frsize，监控告警必须基于f_bavail而非f_bfree。
Linux 下用 statvfs() 读取文件系统块配额和使用率
Linux 系统不提供“用户级磁盘配额”以外的细粒度块级硬限制接口，statvfs() 是最直接、最轻量、无需 root 权限就能拿到当前挂载点块总量/可用块/可用 inode 数的 POSIX 标准函数。它返回的是整个文件系统层面的统计，不是某个用户的配额——这点常被误认为是“获取配额”的入口，实际它只反映空间水位。
关键字段说明：f_blocks 是总块数（以 f_frsize 为单位），f_bfree 是所有用户都可写的空闲块，f_bavail 是普通用户（非 root）实际还能写的块（已扣除保留块）。计算使用率时必须用 f_bavail 和 f_blocks，否则会高估可用空间。
实操注意：
-
statvfs()不触发磁盘 I/O，但结果有缓存延迟（通常几秒），不适合高频轮询 - 路径必须是**挂载点目录**（如
"/home"），不能是普通文件或未挂载路径，否则返回 -1 并设errno = ENOENT - 块大小由
f_frsize给出，不是f_bsize（后者仅用于 I/O 优化建议） - 若需区分“已用 vs 可用”，优先用
(f_blocks - f_bavail)，而非(f_blocks - f_bfree)，避免把 root 保留块算进用户已用空间
Linux 用户级磁盘配额需调用 quotactl() + QCMD() 宏
真正意义上的“某用户在某文件系统上的块配额限制”，得走内核 quota 接口，C++ 中通过 quotactl() 系统调用实现。它不返回结构体，而是靠传入缓冲区地址+命令码来读写配额数据，接口原始且易出错。
典型流程：先用 QCMD(Q_GETQUOTA, USRQUOTA) 构造命令，再传入 struct dqblk 指针接收结果。注意：quotactl() 要求调用进程有 CAP_SYS_ADMIN 或运行在 root 下，普通程序默认失败，errno 为 EPERM。
常见卡点：
- 目标文件系统必须启用 quota（mount 时带
usrquota或grpquota选项，且/etc/fstab中配置了 quota 工具链） -
struct dqblk的字段含义与内核版本强相关（如dqb_bhardlimit单位是 1KB 块，不是文件系统块），跨发行版移植前务必查对应内核头文件 - 不能直接对路径调用，第一个参数是设备名（如
"/dev/sda2"），需先用stat()获取st_dev，再用findmnt或解析/proc/mounts映射到设备
Windows 下用 GetDiskFreeSpaceEx() 获取卷级空间信息
Windows 没有“块配额”概念，只有卷（Volume）级别的总/可用字节数，GetDiskFreeSpaceEx() 是唯一推荐的 API。它返回三个 LARGE_INTEGER：总容量、总可用、当前用户可用（考虑配额策略后）。注意第三个值才是真实可用值，前两个可能包含管理员保留空间或配额外溢部分。
容易忽略的细节：
- 路径必须以
"X:\\"形式传入（尾部双反斜杠），传"X:"或"X:\dir"都会失败并返回ERROR_INVALID_NAME - 若启用了 NTFS 配额（Quota Entries），
lpFreeBytesAvailable就是该用户剩余配额，否则等于lpTotalNumberOfFreeBytes - 该函数不支持网络驱动器（UNC 路径），对映射的网络盘会返回
ERROR_NOT_SUPPORTED - 返回值是字节，不是扇区或簇——别自行除以 512 或 4096 去“还原成块”，那是误导
跨平台封装时别碰 df 和 repquota 这类 shell 命令
用 popen("df -B1") 解析输出看似简单，但存在严重可靠性问题：输出格式随 locale 变（中文系统字段名乱码）、字段顺序不固定（GNU vs BusyBox）、字段间空格数量不可靠（尤其文件系统名含空格时）、权限不足时静默失败。同理，repquota 依赖 quota 工具链安装，且输出无结构化格式。
替代思路更稳：
- Linux 下坚持用
statvfs()+ （必要时）quotactl()，两者都是 glibc 直接封装的 syscall，无外部依赖 - Windows 下只信
GetDiskFreeSpaceEx()，它是 WinAPI 核心函数，稳定性和文档完备性远超命令行 - 若真要兼容旧内核（如 2.4）或嵌入式无 glibc 环境，才考虑 fallback 到
statfs()，但注意其struct statfs字段命名和单位与statvfs()不同（如f_bsize在 statfs 中是文件系统块大小，在 statvfs 中是首选 I/O 块大小）
块级统计本身不复杂，难在边界条件：挂载点识别、权限控制、单位混淆、缓存一致性。写一次封装，至少要在 ext4/xfs/btrfs 和 NTFS 上各跑一遍真实路径测试，别只信 /tmp 的结果。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
