最可靠方式是直接调用Windows API GetDiskFreeSpaceEx，需传入根路径如"C:"，检查返回值，用LARGE_INTEGER接收避免截断，支持UNC路径但要求权限与连通性。
Windows 下用 GetDiskFreeSpaceEx 获取剩余空间最可靠
直接调用 Windows API 是最稳定的方式，不依赖第三方库，也不受路径格式（如 UNC、长路径）意外影响。它返回的是真实的可用字节数，不是“用户配额限制下的剩余”，这点比某些 shell 命令更准确。
常见错误是传入非法路径或忽略返回值检查：GetDiskFreeSpaceEx 在路径不存在、无权限或盘符无效时会返回 FALSE，此时 *lpFreeBytesAvailable 值未定义，直接使用会导致未定义行为。
- 必须传入根路径，例如
"C:\\"（注意双反斜杠转义），不能是"C:"或"C:\Users" - 推荐用
LARGE_INTEGER接收*lpFreeBytesAvailable，避免 32 位截断（尤其在 >4TB 磁盘上） - 若需支持网络驱动器，确保目标已映射且在线；UNC 路径（如
"\\server\share"）也支持，但需调用方有访问权限
// 示例：获取 C 盘剩余字节数
LARGE_INTEGER free;
if (GetDiskFreeSpaceEx(L"C:\", nullptr, nullptr, &free)) {
std::cout << "Free: " << free.QuadPart << " bytes
";
} else {
std::cerr << "GetDiskFreeSpaceEx failed: " << GetLastError() << "
";
}Linux/macOS 下用 statvfs 而非 statfs
statvfs 是 POSIX 标准接口，跨平台兼容性好，返回字段语义清晰（f_bavail 是普通用户可用块数，f_bfree 是 root 可用块数）。而 statfs 各系统实现差异大，比如 Linux 的 struct statfs 字段名和单位不统一，容易误读。
典型坑是混淆 f_bavail 和 f_bfree：多数程序应关注 f_bavail，因为现代文件系统（ext4、XFS、APFS）默认启用 reserved blocks，f_bfree 包含这部分，但普通用户写不了。
立即学习“C++免费学习笔记（深入）”；
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 路径参数可以是任意挂载点下的有效路径，例如
"/home"、"/"，函数自动定位到对应文件系统 - 注意
f_frsize（fragment size）才是计算字节数的正确块大小，别硬写512或4096 - macOS 上
statvfs对 APFS 快照卷返回的f_bavail可能偏保守，但仍是用户实际能写的上限
// 示例：Linux/macOS 获取 / 分区剩余字节数
struct statvfs buf;
if (statvfs("/", &buf) == 0) {
uint64_t free_bytes = static_cast<uint64_t>(buf.f_bavail) * buf.f_frsize;
std::cout << "Free: " << free_bytes << " bytes
";
}跨平台封装要注意 std::filesystem::space 的陷阱
C++17 的 std::filesystem::space 看似简洁，但它在 Windows 上底层仍调用 GetDiskFreeSpaceEx，在 Linux/macOS 上调用 statvfs，逻辑没问题。但问题出在异常处理和路径解析上：
- 传入相对路径（如
"./data"）时，它会先canonical化，若路径不存在或不可访问，抛出std::filesystem::filesystem_error，而不是静默失败 - 某些旧版 libstdc++（GCC space 对符号链接目标路径解析有 bug，可能返回链接所在分区而非目标分区的剩余空间
- 返回的
space_info::available字段等价于f_bavail * f_frsize（Linux/macOS）或lpFreeBytesAvailable（Windows），但不会告诉你是否受配额限制——如果启用了磁盘配额，这个值就是用户配额内剩余，不是物理剩余
建议只在确定路径存在且无需配额感知时使用，否则宁可自己调系统 API。
不要用 system("df -B1") 或 QStorageInfo 替代原生调用
用 system 执行 shell 命令看似简单，但实际问题很多：输出格式随 locale 变化（如德语系统里数字带逗号）、不同发行版 df 默认单位不一致（有些是 512 字节块）、管道解析易出错，且无法捕获权限拒绝等细粒度错误码。
QStorageInfo（Qt）虽跨平台，但它在 Windows 上内部仍走 GetDiskFreeSpaceEx，Linux 上走 statvfs，多一层封装并无收益，反而引入 Qt 依赖和隐式转换（比如把字节数转成 qint64 再转回 uint64_t）。
真正需要跨平台时，用预处理器分发调用即可，几行 #ifdef 比引入重量级抽象更可控、更易调试。
