std::filesystem::space() 返回的 space_info 包含 capacity（总容量）、free（非特权用户空闲字节数）和 available（进程实际可写入字节数），其中 available ≤ free，因后者扣除 root 保留空间、配额及文件系统开销。
std::filesystem::space() 返回的 space_info 到底包含什么
它返回一个 std::filesystem::space_info 结构体，含三个 uintmax_t 成员：capacity（总字节数）、free（非特权用户可用空闲字节数）、available（当前进程实际可写入的字节数）。注意：free ≠ available——后者会扣除 root 保留空间、配额限制、甚至某些文件系统（如 ext4）的 reserved blocks。
调用 std::filesystem::space() 的正确姿势
必须传入一个**有效路径**（不一定是文件，目录也行），且该路径需位于目标文件系统根下；否则可能抛出 std::filesystem::filesystem_error。常见错误是传入空字符串、不存在路径或跨挂载点路径（比如在 Linux 上对 /proc 或 /sys 调用）。
- 推荐用
std::filesystem::temp_directory_path()或std::filesystem::current_path()作为安全起点 - Windows 下路径如
"C:/"可用，但注意结尾斜杠不能少（"C:"是相对路径，行为未定义） - Linux/macOS 下建议用
"/"获取根文件系统，或"/home"查看 home 所在分区
#include <filesystem>
#include <iostream>
int main() {
try {
auto si = std::filesystem::space("/"); // ← 关键：必须是挂载点路径
std::cout << "Capacity: " << si.capacity << " bytes\n";
std::cout << "Free: " << si.free << " bytes\n";
std::cout << "Available:" << si.available << " bytes\n";
} catch (const std::filesystem::filesystem_error& e) {
std::cerr << "Error: " << e.what() << "\n";
}
}
为什么 available 比 free 小？哪些场景会放大这个差值
差值主要来自三类限制：root reserved space（ext4 默认保留 5%）、user quotas（磁盘配额）、file system overhead（如 XFS 的 AG 管理块）。在容器或 CI 环境中尤其明显——Docker overlay2 层、GitHub Actions 的 runner 磁盘常设配额，导致 available 远低于 free。
- 检查是否启用配额：
quota -u $USER（Linux）或repquota -a - 查看 ext4 保留比例：
tune2fs -l /dev/sda1 | grep "Reserved block count" - 生产代码中判断磁盘是否“够用”，应始终用
available，而非free或capacity
Windows 和 Linux 下 behavior 差异与兼容性注意点
Windows（NTFS）通常不区分 free 和 available，二者值相等；而 Linux（ext4/xfs/btrfs）严格区分。C++20 标准未强制要求实现差异，所以依赖 available == free 会出问题。
立即学习“C++免费学习笔记（深入）”；
- 编译时确保开启 C++20：
-std=c++20（GCC/Clang）或/std:c++20（MSVC） - MSVC 需链接
Shlwapi.lib（已默认包含），但 MinGW-w64 某些旧版本需手动加-lshlwapi - 交叉编译或嵌入式环境（如 musl libc）可能未完全实现
std::filesystem，建议先#ifdef __cpp_lib_filesystem检查
free —— 写日志、解压包、生成缓存前，务必用 available 做容量预检，否则在配额受限的服务器上容易 runtime fail。 
