std::filesystem::space() 是 c++17 起跨平台获取路径所在分区剩余空间的最直接方法，返回 space_info 中 available（用户可用字节数）最实用，需传入已存在且有读权限的有效目录路径（如 "c:" 或 "/home"），避免不存在路径或纯盘符导致异常。
用 std::filesystem::space() 获取分区剩余空间最直接
Windows 和 Linux 下都支持，C++17 起可用，不需要调用系统 API 或第三方库。关键不是“查某个文件路径占多少空间”，而是“查该路径所在分区的剩余空间”——std::filesystem::space() 的设计就是干这个的。
它返回一个 std::filesystem::space_info 结构体，其中 available 是普通用户可写入的字节数（考虑权限和预留空间），free 是未分配字节数（含 root 预留），通常更推荐用 available。
常见错误是传入一个不存在的路径（比如 "D:\nonexistent"），这时会抛 std::filesystem::filesystem_error；或者传入相对路径但当前工作目录不在目标盘符，导致误判成其他分区。
- 务必传入**已存在的、有读取权限的路径**（哪怕只是根目录，如
"C:\"或"/home"） - 路径必须指向一个**挂载点或有效目录**，不能是纯字符串盘符（如
"D:"在 Windows 下可能失败） - 跨平台时注意路径分隔符：Windows 用反斜杠或双正斜杠，Linux/macOS 用正斜杠
#include <filesystem>
#include <iostream><p>int main() {
try {
auto space_info = std::filesystem::space("C:");
std::cout </p>
<h3>Windows 下 <code>GetDiskFreeSpaceEx()</code> 更底层但需处理宽字符</h3>
<p>当 <code>std::filesystem::space()</code> 不可用（比如旧编译器、没开 C++17）或你需要获取更细粒度信息（如 total bytes available to caller，即当前进程实际能写的上限），就得回退到 Win32 API。</p>
<p><code>GetDiskFreeSpaceEx()</code> 返回三个 <code>ULARGE_INTEGER*</code>，分别对应总容量、可用空间（含 quota）、以及“当前用户/进程可用空间”。它比 <code>std::filesystem::space()</code> 多一个维度，但代价是 Windows 专属、需链接 <code>kernel32.lib</code>、且路径必须是宽字符串（<code>L"C:"</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>
<ul>
<li>路径末尾必须带反斜杠，否则可能返回错误结果（例如 <code>L"C:"</code> 不行，<code>L"C:\"</code> 才行）</li>
<li>不要用 <code>char*</code> 直接传，必须转 <code>wchar_t*</code>；MSVC 默认启用 Unicode，但 MinGW 可能需要手动定义 <code>_UNICODE</code>
</li>
<li>返回值为 <code>BOOL</code>，失败时需检查 <code>GetLastError()</code>，常见错误码包括 <code>ERROR_PATH_NOT_FOUND</code>（路径无效）和 <code>ERROR_ACCESS_DENIED</code>（权限不足）</li>
</ul>
<h3>Linux/macOS 下 <code>statvfs()</code> 是 <code>std::filesystem::space()</code> 的底层实现</h3>
<p>如果你在调试 <code>std::filesystem::space()</code> 行为异常，或者嵌入式环境禁用 STL 文件系统，可以直接调 <code>statvfs()</code>。它和 C++ 标准库行为基本一致：<code>f_bavail * f_frsize</code> 对应 <code>available</code>，<code>f_bfree * f_frsize</code> 对应 <code>free</code>。</p>
<p>注意：传入路径必须是挂载点（如 <code>"/"</code>、<code>"/home"</code>），不能是符号链接终点（<code>statvfs()</code> 不自动解析 symlink）；若路径是空目录或只读挂载，<code>f_bavail</code> 可能为 0。</p>
<ul>
<li>头文件是 <code><sys></sys></code>，不是 <code><sys></sys></code>
</li>
<li>
<code>f_frsize</code> 是“fragment size”，不是 <code>f_bsize</code>（block size），后者可能不反映真实分配粒度</li>
<li>计算字节数时务必先转 <code>uint64_t</code> 再乘，避免 <code>long</code> 溢出（尤其在大硬盘上）</li>
</ul>
<pre class="brush:php;toolbar:false;">#include <sys>
#include <iostream><p>int main() {
struct statvfs buf;
if (statvfs("/home", &buf) == 0) {
uint64_t available = static_cast<uint64_t>(buf.f_bavail) <em> buf.f_frsize;
std::cout 1024) </em></uint64_t></p>
<h3>跨平台封装要注意挂载点识别和权限兜底</h3>
<p>真正工程中，你往往不知道用户想查哪个盘符或挂载点。这时候不能硬写 <code>"C:\"</code> 或 <code>"/"</code>，得先枚举本地挂载点（Windows 的逻辑驱动器、Linux 的 <code>/proc/mounts</code> 或 <code>getmntent()</code>），再逐个调用 <code>space()</code> 并过滤掉网络盘、临时文件系统（<code>tmpfs</code>）、或无权限访问的路径。</p>
<p>最容易被忽略的是：即使路径存在，也可能因 SELinux、user namespace、容器挂载限制等原因导致 <code>space()</code> 抛异常。生产代码里别假设一次调用就成功，要加重试或降级逻辑（比如失败时返回 -1 或 fallback 到 <code>df -P</code> 命令解析）。</p>
<ul>
<li>Windows 枚举驱动器用 <code>GetLogicalDrives()</code> + <code>GetDriveType()</code> 过滤掉 CD-ROM、RAM disk</li>
<li>Linux 枚举建议用 <code>setmntent("/proc/mounts", "r")</code>，跳过 <code>none</code>、<code>devtmpfs</code>、<code>overlay</code> 等非物理存储类型</li>
<li>所有路径传给 <code>std::filesystem::space()</code> 前，先用 <code>std::filesystem::exists()</code> 和 <code>std::filesystem::is_directory()</code> 做轻量校验</li>
</ul></iostream></sys>C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
