C++如何使用std::filesystem::space获取磁盘剩余空间-C++-PHP中文网

c++oding="utf-8" ?>

std::filesystem::space 返回的 space_info 中 available 才是用户实际可用空间，free 包含系统保留空间；需传有效路径并捕获异常，跨平台时注意 reserved blocks、配额、快照等影响，应优先用 available 判断写入能力。

c++如何使用std::filesystem::space获取磁盘剩余空间

std::filesystem::space 返回值怎么看

std::filesystem::space 返回一个 std::filesystem::space_info 结构体，包含三个 uintmax_t 成员：capacity（总容量）、free（可用字节数）、available（非特权用户可用字节数）。注意：free ≠ 剩余空间显示值——Windows 资源管理器或 df -h 显示的“可用”通常对应 available，因为它排除了 reserved blocks（Linux）或系统保留空间（Windows）。

常见误用是直接打印 free 并当作“用户能用的空间”，结果比实际可写入空间大几百 MB 到几 GB，尤其在小容量磁盘或 ext4 默认 5% reserved 情况下更明显。

调用 std::filesystem::space 的基本写法

必须传入一个有效的路径（可以是目录或文件），但函数实际查询的是该路径所在文件系统的根设备信息。传 "."、"/" 或 "C:\" 都行，但不能传不存在的路径或空字符串——否则抛出 std::filesystem::filesystem_error。

示例：

#include <filesystem>
#include <iostream><p>int main() {
try {
auto space_info = std::filesystem::space(".");
std::cout </p>
<p>关键点：</p>
<ul>
<li>
<code>std::filesystem</code> 在 C++17 引入，编译需加 <code>-std=c++17</code>（GCC/Clang）或 /std:c++17（MSVC）</li>
<li>MSVC 需链接 <code>shlwapi.lib</code>（自动处理，一般不用手动加）；GCC/Clang 链接时可能需 <code>-lstdc++fs</code>（GCC 9 及以前），GCC 10+ 和 Clang 通常内置</li>
<li>路径参数不一定要存在——但若路径本身不存在（如 <code>"nonexistent/"</code>），会抛异常；若路径存在但无权限访问（如 <code>/root</code> 普通用户），也可能失败</li>
</ul>
<h3>跨平台行为差异和兼容性陷阱</h3>
<p><code>std::filesystem::space</code> 在 Linux、Windows、macOS 上语义一致，但底层实现依赖 OS API，导致细微差别：</p>
<p>Linux：<code>free</code> 对应 <code>statvfs.f_bfree</code>，<code>available</code> 对应 <code>statvfs.f_bavail</code>；ext4 默认保留 5% 空间给 root，<code>available</code> 已扣除这部分。</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>
<p>Windows：<code>available</code> 和 <code>free</code> 通常相等（NTFS 无 reserved blocks），但若启用了配额（Quota）或压缩卷，<code>available</code> 可能小于 <code>free</code>。</p>
<p>macOS：HFS+/APFS 下二者也基本一致，但 APFS 快照可能占用空间却不反映在 <code>available</code> 中——<code>space()</code> 无法感知快照，所以显示的 “可用” 可能比实际能写的多。</p>
<p>容易踩的坑：</p>
<ul>
<li>用 <code>free</code> 判断是否能写入大文件 → 应该用 <code>available</code>
</li>
<li>在容器或 WSL 中调用，路径挂载方式影响结果（如 Docker volume 绑定到宿主机某目录，<code>space(".");</code> 查的是宿主机对应文件系统）</li>
<li>未捕获异常就假设调用成功 → 权限不足、路径跨网络驱动器（SMB/NFS）、文件系统不支持（某些 FUSE 实现）都会抛异常</li>
</ul>
<h3>如何安全地获取并格式化剩余空间</h3>
<p>直接输出字节不友好，建议转成 KiB/MiB/GiB，并优先展示 <code>available</code>。注意整数除法截断问题，别用 <code>/ 1024 / 1024</code> 这种链式除法算 GiB（易溢出且精度丢）。</p>
<p>推荐做法：</p>
<pre class="brush:php;toolbar:false;">auto avail = space_info.available;
double gib = avail / static_cast<double>(1024 * 1024 * 1024);
std::cout <p>更健壮的判断逻辑（比如预留 100 MiB 缓冲）：</p>
<ul>
<li>检查 <code>space_info.available != static_cast<uintmax_t>(-1)</uintmax_t></code>（部分旧实现错误返回 -1 表示失败，虽标准未规定，但实测某些 MinGW 版本会）</li>
<li>写入前再次调用 <code>space()</code>，避免竞态（其他进程瞬间占满磁盘）</li>
<li>对关键路径（如日志目录）做 <code>std::filesystem::exists()</code> + <code>std::filesystem::is_directory()</code> 双重校验，再调 <code>space()</code>
</li>
</ul>
<p>真正难的不是调用这个函数，而是理解它返回的数字在不同上下文里到底代表什么——尤其当磁盘告警阈值设为 “剩余 free 判断时，可能永远收不到告警。</p></double>

C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！