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 
#include 

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 检查