Windows 用 GetDiskFreeSpaceEx 获取磁盘空间最直接，需传根路径、检查返回值，注意 *lpFreeBytesAvailable 是当前用户可用空间；Linux/macOS 应用 statvfs，乘 f_frsize 得字节数，f_bavail 为非特权用户可用空间，且须解析挂载点而非符号链接。
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 是系统级剩余块数。
立即学习“C++免费学习笔记（深入）”；
- 路径可以是任意文件或目录（自动定位到所在挂载点），无需是根路径
- 务必检查返回值：失败时
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，你拿到的是目标设备的空间，不是“看起来所在位置”的设备。必须先解析到真实挂载点。
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（是否只读）一起判断。
- 写入前应同时检查空间和 inode：
f_bavail > needed_blocks && f_favail > needed_inodes - 某些容器环境（如 Docker overlay2）中，
f_bavail可能反映上层镜像层限制，而非宿主机磁盘真实状态 - 没有跨平台方式绕过这个差异——必须按平台分别处理逻辑，别试图用统一公式估算
事情说清了就结束。
