C++如何获取硬盘分区的剩余空间大小

在C++17标准发布之前，开发者想要获取硬盘分区的剩余空间大小，往往需要调用不同操作系统的专属API，比如Windows下的GetDiskFreeSpaceEx函数，或者Linux下的statvfs函数，这种方式不仅代码冗余，还增加了跨平台开发的难度。C++17引入的filesystem标准库统一了文件系统操作的接口，其中space函数可以直接获取指定路径所在分区的磁盘空间信息，包括总容量、剩余可用空间等，完美解决了跨平台的问题。

filesystem库基础说明

filesystem库是C++17正式纳入标准库的组件，主要用于处理文件系统相关的操作，比如路径处理、文件读写判断、目录遍历等。要使用filesystem库的功能，首先需要包含对应的头文件，并且注意不同编译器的命名空间差异。

在大部分支持C++17的编译器中，filesystem相关的类和函数都位于<filesystem>头文件，命名空间为std::filesystem。不过部分旧版本的GCC编译器可能将filesystem放在experimental命名空间下，使用时需要额外注意。

space函数的使用方式

filesystem库中的space函数是获取磁盘空间信息的核心函数，它的函数原型如下：

#include <filesystem>
namespace fs = std::filesystem;

// space函数原型
fs::space_info space(const fs::path& p, std::error_code& ec) noexcept;

space函数接收一个路径参数，这个路径可以是任意存在的文件或者目录路径，函数会自动找到该路径所在的分区，返回该分区的空间信息。返回值是fs::space_info结构体，该结构体的定义如下：

struct space_info {
    uintmax_t capacity;  // 分区总容量，单位字节
    uintmax_t free;      // 分区剩余总空间，单位字节
    uintmax_t available; // 当前用户可用的剩余空间，单位字节
};

这里需要注意free和available的区别：free是分区上未被使用的所有空间，而available是当前进程可以实际使用的剩余空间，部分系统会为管理员保留一部分磁盘空间，这部分空间不会计入available中。

完整实现示例

下面是一个完整的示例程序，演示如何获取指定分区的剩余空间大小，并且将字节单位转换为更易读的GB单位：

#include <iostream>
#include <filesystem>
#include <system_error>
#include <iomanip>

namespace fs = std::filesystem;

// 字节转换为GB的辅助函数
double byte_to_gb(uintmax_t bytes) {
    return static_cast<double>(bytes) / (1024 * 1024 * 1024);
}

int main() {
    // 要查询的路径，这里以C盘根目录为例，Linux可以换成"/"或者"/home"
    fs::path target_path = "C:/";
    std::error_code ec;

    // 调用space函数获取空间信息
    fs::space_info disk_info = fs::space(target_path, ec);

    // 判断调用是否成功
    if (ec) {
        std::cerr << "获取磁盘空间失败，错误信息：" << ec.message() << std::endl;
        return 1;
    }

    // 输出磁盘空间信息
    std::cout << std::fixed << std::setprecision(2);
    std::cout << "目标路径：" << target_path << std::endl;
    std::cout << "分区总容量：" << byte_to_gb(disk_info.capacity) << " GB" << std::endl;
    std::cout << "分区剩余总空间：" << byte_to_gb(disk_info.free) << " GB" << std::endl;
    std::cout << "当前用户可用空间：" << byte_to_gb(disk_info.available) << " GB" << std::endl;

    return 0;
}

编译与运行注意事项

由于filesystem是C++17的特性，编译时需要指定C++17及以上标准，不同编译器的编译指令如下：

• GCC编译器：添加编译参数-std=c++17 -lstdc++fs，注意部分新版本GCC不需要额外链接-lstdc++fs
• Clang编译器：添加编译参数-std=c++17
• MSVC编译器：确保使用Visual Studio 2017及以上版本，项目属性中设置C++语言标准为C++17，无需额外链接库

另外需要注意，传入space函数的路径必须是已经存在的路径，如果路径不存在，space函数会返回错误，因此实际使用时可以先判断路径是否存在，或者像示例中一样通过error_code捕获错误。

常见问题说明

很多开发者会遇到查询到的空间大小和系统显示不一致的问题，通常有以下两个原因：

1. 单位转换的精度问题，系统显示通常会做四舍五入，而程序计算的是精确值，只要误差在合理范围内都属于正常情况
2. available和free的混淆，系统显示的可用空间通常是available的值，而不是free的值，因此对比时要注意对应字段

如果需要查询多个分区的空间，只需要将target_path替换为不同分区的路径即可，比如Windows下的D盘可以设置为"D:/"，Linux下的其他挂载点可以设置为对应的挂载路径。

C++filesystem库硬盘分区剩余空间磁盘空间修改时间：2026-07-05 16:33:29