c++oding="utf-8" ?>
最可靠方式是直接调用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 <h3>Linux/macOS 下用 <code>statvfs</code> 而非 <code>statfs</code>
</h3><p><code>statvfs</code> 是 POSIX 标准接口，跨平台兼容性好，返回字段语义清晰（<code>f_bavail</code> 是普通用户可用块数，<code>f_bfree</code> 是 root 可用块数）。而 <code>statfs</code> 各系统实现差异大，比如 Linux 的 <code>struct statfs</code> 字段名和单位不统一，容易误读。</p><p>典型坑是混淆 <code>f_bavail</code> 和 <code>f_bfree</code>：多数程序应关注 <code>f_bavail</code>，因为现代文件系统（ext4、XFS、APFS）默认启用 reserved blocks，<code>f_bfree</code> 包含这部分，但普通用户写不了。</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill5502" title="C++ Code Review Master"><img
src="https://img.php.cn/upload/skill/000/000/081/179051228971575.jpg" alt="C++ Code Review Master" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/skill5502" title="C++ Code Review Master" class="overflowclass">C++ Code Review Master</a>
<p class="overflowclass">组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。</p>
</div>
<a rel="nofollow" href="/xiazai/skill5502" title="C++ Code Review Master" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div>
- 路径参数可以是任意挂载点下的有效路径，例如
"/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 <h3>跨平台封装要注意 <code>std::filesystem::space</code> 的陷阱</h3>
<p>C++17 的 <code>std::filesystem::space</code> 看似简洁，但它在 Windows 上底层仍调用 <code>GetDiskFreeSpaceEx</code>，在 Linux/macOS 上调用 <code>statvfs</code>，逻辑没问题。但问题出在异常处理和路径解析上：</p>
<ul>
<li>传入相对路径（如 <code>"./data"</code>）时，它会先 <code>canonical</code> 化，若路径不存在或不可访问，抛出 <code>std::filesystem::filesystem_error</code>，而不是静默失败</li>
<li>某些旧版 libstdc++（GCC space 对符号链接目标路径解析有 bug，可能返回链接所在分区而非目标分区的剩余空间</li>
<li>返回的 <code>space_info::available</code> 字段等价于 <code>f_bavail * f_frsize</code>（Linux/macOS）或 <code>lpFreeBytesAvailable</code>（Windows），但不会告诉你是否受配额限制——如果启用了磁盘配额，这个值就是用户配额内剩余，不是物理剩余</li>
</ul>
<p>建议只在确定路径存在且无需配额感知时使用，否则宁可自己调系统 API。</p>
<h3>不要用 <code>system("df -B1")</code> 或 <code>QStorageInfo</code> 替代原生调用</h3>
<p>用 <code>system</code> 执行 shell 命令看似简单，但实际问题很多：输出格式随 locale 变化（如德语系统里数字带逗号）、不同发行版 <code>df</code> 默认单位不一致（有些是 512 字节块）、管道解析易出错，且无法捕获权限拒绝等细粒度错误码。</p>
<p><code>QStorageInfo</code>（Qt）虽跨平台，但它在 Windows 上内部仍走 <code>GetDiskFreeSpaceEx</code>，Linux 上走 <code>statvfs</code>，多一层封装并无收益，反而引入 Qt 依赖和隐式转换（比如把字节数转成 <code>qint64</code> 再转回 <code>uint64_t</code>）。</p>
<p>真正需要跨平台时，用预处理器分发调用即可，几行 <code>#ifdef</code> 比引入重量级抽象更可控、更易调试。</p></uint64_t>C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
