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