std::filesystem::space() 返回 std::filesystem::space_info 结构体，含 capacity（总容量）、free（空闲字节）、available（当前进程实际可用字节数，已扣权限和预留空间）；必须传入有效路径并捕获 filesystem_error 异常。
用 std::filesystem::space() 获取分区剩余空间最直接
标准库 std::filesystem（C++17 起）提供了跨平台的磁盘空间查询能力，std::filesystem::space() 是唯一需要调用的函数。它返回一个 std::filesystem::space_info 结构体，含三个关键字段：capacity（总字节）、free（空闲字节）、available（用户可用字节，已扣权限/预留空间）。注意：free ≠ available，尤其在 Linux 或启用了配额的系统上，available 才是真实可用值。
实操建议：
- 传入路径必须是**已存在的目录或文件**，不能是空字符串或非法路径，否则抛
std::filesystem::filesystem_error - 路径应指向目标分区的某个挂载点（如 Windows 的
"C:/"、Linux 的"/home"），而非任意子路径——同一分区下任意有效路径返回结果相同 - 若需获取当前工作目录所在分区，可传
std::filesystem::current_path() - Windows 下路径分隔符用正斜杠
"/"或双反斜杠"\"均可，但单反斜杠""会触发转义错误
Windows 下获取 C 盘剩余空间的典型写法
常见错误是硬编码 "C:" 却未正确转义，或忽略异常处理导致程序崩溃。以下为安全写法：
#include <filesystem>
#include <iostream>
int main() {
try {
auto s = std::filesystem::space("C:/"); // 推荐用正斜杠，简洁无歧义
std::cout
<p>关键点：</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/gongju/2823" title="C++14"><img
src="https://img.php.cn/upload/manual/001/431/639/6ac8b33c327c4749.png" alt="C++14" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/gongju/2823" title="C++14" class="overflowclass">C++14</a>
<p class="overflowclass">C++14 对 C++11 的修正与增强版本，适合旧系统维护和较老工具链兼容。</p>
</div>
<a rel="nofollow" href="/xiazai/gongju/2823" title="C++14" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div>
<ul>
<li>用 <code>"C:/"</code> 而非 <code>"C:"</code> 或 <code>"C:"</code> —— 后者在某些实现中可能被解释为相对路径，行为不一致</li>
<li>必须捕获 <code>std::filesystem::filesystem_error</code>，例如路径不存在、无权限访问、驱动器未就绪（如光驱无盘）都会触发该异常</li>
<li>不要依赖 <code>s.free</code> 显示“剩余空间”，它包含 root 预留空间；面向用户展示请用 <code>s.available</code>
</li>
</ul>
<h3>Linux/macOS 下获取根分区或 home 分区空间</h3>
<p>Linux 和 macOS 行为一致，但要注意挂载点概念。例如 <code>"/"</code> 对应根分区，<code>"/home"</code> 可能是独立分区。若误传 <code>"/nonexistent"</code>，会因路径不存在而抛异常；若传 <code>"/tmp"</code>（常为 tmpfs 内存文件系统），<code>space()</code> 返回的是内存虚拟空间，不是硬盘。</p>
<p>实操建议：</p>
<ul>
<li>确认目标路径确属硬盘分区：可通过 <code>df -T /path</code>（Linux/macOS）验证文件系统类型是否为 <code>ext4</code>、<code>xfs</code>、<code>apfs</code> 等物理存储类型</li>
<li>避免传符号链接路径——<code>space()</code> 会解析到目标实际挂载点，可能不是你预期的分区</li>
<li>权限问题更常见：普通用户无法读取某些系统路径（如 <code>/boot</code>），此时异常信息通常含 <code>Permission denied</code>
</li>
<li>若需遍历所有挂载点，C++ 标准库不提供接口，需调用系统命令（如 <code>popen("df -P | awk 'NR>1 {print $6}'", "r")</code>）或使用平台 API（<code>statvfs</code>）</li>
</ul>
<h3>单位换算与精度陷阱</h3>
<p><code>std::filesystem::space_info</code> 所有字段都是 <code>uintmax_t</code> 类型的字节数，直接输出数字对用户不友好。但简单除以 1024 或 1000 容易出错：</p>
<ul>
<li>行业惯例是二进制前缀（KiB/MiB/GiB）：1 KiB = 1024 字节，1 MiB = 1024² 字节</li>
<li>别用 <code>float</code> 或 <code>double</code> 做大数除法——64 位整数（如 2TB ≈ 2×10¹² 字节）转 float 会丢失精度，显示为 <code>1.99999e+12</code> 这类近似值</li>
<li>推荐用整数运算 + 余数判断：先除以 1024³ 得 GiB，再对余数除以 1024² 得 MiB，依此类推</li>
<li>注意 <code>available</code> 可能为 0（磁盘满或配额耗尽），需单独判断避免除零或负数显示</li>
</ul>
<p>真正麻烦的从来不是调用哪个函数，而是搞清你要的到底是「磁盘空闲总量」还是「当前用户还能写多少」，以及路径是否真落在目标物理设备上——这两个点没踩准，后面所有计算都白搭。</p></iostream></filesystem>C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
