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">
<div class="artcardd flexRow">
<a class="aritcle_card_img" 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 href="/xiazai/skill5502" title="C++ Code Review Master">C++ Code Review Master</a>
<p>组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。</p>
</div>
<a href="/xiazai/skill5502" title="C++ Code Review Master" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div><p><span>立即学习</span>“<a href="https://pan.quark.cn/s/6e7abc4abb9f" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">C++免费学习笔记（深入）</a>”；</p><p>int main() {
try {
auto s = fs::space("C:/"); // Windows 示例
std::cout << "可用空间: " << s.available / (1024 <em> 1024 </em> 1024) << " GB\n";
} catch (const fs::filesystem_error& e) {
std::cerr << "获取空间失败: " << e.what() << "\n";
return 1;
}
}- Windows 下传
"C:/"比"C:"更稳妥（后者可能被解释为相对路径） - Linux/macOS 下传
"/"即可；若查子挂载点（如"/home"），确保路径存在且可访问 - 不要传
fs::current_path()的结果而不检查——当前工作目录可能在不可读挂载点上 - C++17 起支持，编译需加
-std=c++17，GCC/Clang 还需链接-lstdc++fs（GCC<11）
为什么 space() 在某些路径返回 0 或抛出 permission denied
典型错误现象：std::filesystem::space("/mnt/broken-nfs") 返回 available == 0，或直接 throw permission denied。这不是函数失效，而是底层 statvfs()（POSIX）或 GetDiskFreeSpaceEx()（Windows）系统调用的原生行为。
- NFS/CIFS 挂载点若服务端宕机或权限配置错误，
statvfs可能返回 -1 并设errno = EACCES→ 触发 exception - 某些只读文件系统（如光盘镜像、
overlayfslowerdir）会返回available == 0 - Windows 上若路径指向网络驱动器（如
Z:）但未连接，会抛出not_supported类错误 - 解决方法：先用
fs::exists(path) && fs::is_directory(path)快速预检，但无法替代space()的实际调用 —— 存在性不等于可查询磁盘空间
避免整数溢出和单位混淆的实用技巧
space_info 字段类型是 std::uintmax_t，现代硬盘轻松超 10TB，直接转 double 再除 1024³ 容易精度丢失。更安全的做法是用整数除法分步计算 GiB/MB，或借助 std::format（C++20）格式化。
- 别写
s.available / 1073741824.0（double 仅 15~17 位有效数字，16TB 以上开始丢精度） - 推荐：先转
double再除1024.0 * 1024.0 * 1024.0，或用std::div(s.available, 1024ULL * 1024 * 1024) - 显示时建议保留一位小数：用
std::printf("%.1f GB", s.available / 1024.0 / 1024.0 / 1024.0) - 注意：Windows 资源管理器显示的“XX GB”是 GiB（二进制），不是 GB（十进制），所以统一用 1024³ 是对的
真正难处理的不是 API 调用本身，而是挂载点状态瞬息万变 —— 空间可能在你拿到 available 值后 10ms 就被另一个进程占满。业务逻辑中需要空间阈值告警时，务必加锁或重试机制，而不是依赖单次 space() 结果做关键决策。
