std::filesystem::space返回std::filesystem::space_info结构体，含capacity（总容量）、free（未占用字节数）、available（当前进程实际可写入字节数）；其中available才是判断磁盘是否够用的可靠依据，因它已扣除用户配额、保留空间等限制。
std::filesystem::space 返回的是什么值
std::filesystem::space 返回一个 std::filesystem::space_info 结构体，包含三个字段：capacity（总容量）、free（可用字节数）、available（非特权用户可用字节数）。注意：free ≠ 剩余空间显示值 —— 它包含被保留但未使用的空间（如 ext4 的 reserved blocks），而文件管理器通常显示的是 available，也就是普通用户真正能写入的字节数。
常见误解是直接用 free 除以 1024³ 当 GB 显示，结果比系统“属性”里看到的大几 GB。这是正常现象，不是 bug。
-
available才是判断“磁盘是否快满”的可靠依据 -
free≥available，差值通常是 root 保留空间（Linux）或 NTFS 卷影副本预留（Windows） - 在容器或受限挂载点（如
/proc、/sys）上调用会抛出std::filesystem::filesystem_error
跨平台调用 std::filesystem::space 的最小安全写法
必须捕获异常，且路径需是**已挂载的、可访问的目录路径**（不能是空字符串、不存在路径或符号链接末尾未解析的路径）。推荐用根路径（如 "C:/" 或 "/"）或用户指定的有效目录。
#include <filesystem>
#include <iostream><p>namespace fs = std::filesystem;</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>
<p>int main() {
try {
auto s = fs::space("C:/"); // Windows 示例
std::cout 1024 1024) </p>
<ul>
<li>Windows 下传 <code>"C:/"</code> 比 <code>"C:"</code> 更稳妥（后者可能被解释为相对路径）</li>
<li>Linux/macOS 下传 <code>"/"</code> 即可；若查子挂载点（如 <code>"/home"</code>），确保路径存在且可访问</li>
<li>不要传 <code>fs::current_path()</code> 的结果而不检查——当前工作目录可能在不可读挂载点上</li>
<li>C++17 起支持，编译需加 <code>-std=c++17</code>，GCC/Clang 还需链接 <code>-lstdc++fs</code>（GCC</li>
</ul>
<h3>为什么 space() 在某些路径返回 0 或抛出 permission denied</h3>
<p>典型错误现象：<code>std::filesystem::space("/mnt/broken-nfs")</code> 返回 <code>available == 0</code>，或直接 throw <code>permission denied</code>。这不是函数失效，而是底层 <code>statvfs()</code>（POSIX）或 <code>GetDiskFreeSpaceEx()</code>（Windows）系统调用的原生行为。</p>
<ul>
<li>NFS/CIFS 挂载点若服务端宕机或权限配置错误，<code>statvfs</code> 可能返回 -1 并设 <code>errno = EACCES</code> → 触发 exception</li>
<li>某些只读文件系统（如光盘镜像、<code>overlayfs</code> lowerdir）会返回 <code>available == 0</code>
</li>
<li>Windows 上若路径指向网络驱动器（如 <code>Z:</code>）但未连接，会抛出 <code>not_supported</code> 类错误</li>
<li>解决方法：先用 <code>fs::exists(path) && fs::is_directory(path)</code> 快速预检，但无法替代 <code>space()</code> 的实际调用 —— 存在性不等于可查询磁盘空间</li>
</ul>
<h3>避免整数溢出和单位混淆的实用技巧</h3>
<p><code>space_info</code> 字段类型是 <code>std::uintmax_t</code>，现代硬盘轻松超 10TB，直接转 double 再除 1024³ 容易精度丢失。更安全的做法是用整数除法分步计算 GiB/MB，或借助 <code>std::format</code>（C++20）格式化。</p>
<ul>
<li>别写 <code>s.available / 1073741824.0</code>（double 仅 15~17 位有效数字，16TB 以上开始丢精度）</li>
<li>推荐：先转 <code>double</code> 再除 <code>1024.0 * 1024.0 * 1024.0</code>，或用 <code>std::div(s.available, 1024ULL * 1024 * 1024)</code>
</li>
<li>显示时建议保留一位小数：用 <code>std::printf("%.1f GB", s.available / 1024.0 / 1024.0 / 1024.0)</code>
</li>
<li>注意：Windows 资源管理器显示的“XX GB”是 GiB（二进制），不是 GB（十进制），所以统一用 1024³ 是对的</li>
</ul>
<p>真正难处理的不是 API 调用本身，而是挂载点状态瞬息万变 —— 空间可能在你拿到 <code>available</code> 值后 10ms 就被另一个进程占满。业务逻辑中需要空间阈值告警时，务必加锁或重试机制，而不是依赖单次 <code>space()</code> 结果做关键决策。</p></iostream></filesystem>C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
