std::filesystem::space 返回的 space_info 中 available 才是用户实际可用空间，free 包含系统保留空间；需传有效路径并捕获异常，跨平台时注意 reserved blocks、配额、快照等影响，应优先用 available 判断写入能力。
std::filesystem::space 返回值怎么看
std::filesystem::space 返回一个 std::filesystem::space_info 结构体，包含三个 uintmax_t 成员：capacity（总容量）、free（可用字节数）、available（非特权用户可用字节数）。注意：free ≠ 剩余空间显示值——Windows 资源管理器或 df -h 显示的“可用”通常对应 available，因为它排除了 reserved blocks（Linux）或系统保留空间（Windows）。
常见误用是直接打印 free 并当作“用户能用的空间”，结果比实际可写入空间大几百 MB 到几 GB，尤其在小容量磁盘或 ext4 默认 5% reserved 情况下更明显。
调用 std::filesystem::space 的基本写法
必须传入一个有效的路径（可以是目录或文件），但函数实际查询的是该路径所在文件系统的根设备信息。传 "."、"/" 或 "C:\" 都行，但不能传不存在的路径或空字符串——否则抛出 std::filesystem::filesystem_error。
示例：
立即学习“C++免费学习笔记（深入）”；
#include <filesystem>
#include <iostream>
<p>int main() {
try {
auto space_info = std::filesystem::space(".");
std::cout << "Available: " << space_info.available << " bytes
";
} catch (const std::filesystem::filesystem_error& e) {
std::cerr << "space() failed: " << e.what() << "
";
}
}关键点：
-
std::filesystem在 C++17 引入，编译需加-std=c++17（GCC/Clang）或 /std:c++17（MSVC） - MSVC 需链接
shlwapi.lib（自动处理，一般不用手动加）；GCC/Clang 链接时可能需-lstdc++fs（GCC 9 及以前），GCC 10+ 和 Clang 通常内置 - 路径参数不一定要存在——但若路径本身不存在（如
"nonexistent/"），会抛异常；若路径存在但无权限访问（如/root普通用户），也可能失败
跨平台行为差异和兼容性陷阱
std::filesystem::space 在 Linux、Windows、macOS 上语义一致，但底层实现依赖 OS API，导致细微差别：
Linux：free 对应 statvfs.f_bfree，available 对应 statvfs.f_bavail；ext4 默认保留 5% 空间给 root，available 已扣除这部分。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
Windows：available 和 free 通常相等（NTFS 无 reserved blocks），但若启用了配额（Quota）或压缩卷，available 可能小于 free。
macOS：HFS+/APFS 下二者也基本一致，但 APFS 快照可能占用空间却不反映在 available 中——space() 无法感知快照，所以显示的 “可用” 可能比实际能写的多。
容易踩的坑：
- 用
free判断是否能写入大文件 → 应该用available - 在容器或 WSL 中调用，路径挂载方式影响结果（如 Docker volume 绑定到宿主机某目录，
space(".");查的是宿主机对应文件系统） - 未捕获异常就假设调用成功 → 权限不足、路径跨网络驱动器（SMB/NFS）、文件系统不支持（某些 FUSE 实现）都会抛异常
如何安全地获取并格式化剩余空间
直接输出字节不友好，建议转成 KiB/MiB/GiB，并优先展示 available。注意整数除法截断问题，别用 / 1024 / 1024 这种链式除法算 GiB（易溢出且精度丢）。
推荐做法：
auto avail = space_info.available; double gib = avail / static_cast<double>(1024 * 1024 * 1024); std::cout << "Available: " << std::fixed << std::setprecision(2) << gib << " GiB ";
更健壮的判断逻辑（比如预留 100 MiB 缓冲）：
- 检查
space_info.available != static_cast<uintmax_t>(-1)（部分旧实现错误返回 -1 表示失败，虽标准未规定，但实测某些 MinGW 版本会） - 写入前再次调用
space()，避免竞态（其他进程瞬间占满磁盘） - 对关键路径（如日志目录）做
std::filesystem::exists()+std::filesystem::is_directory()双重校验，再调space()
真正难的不是调用这个函数，而是理解它返回的数字在不同上下文里到底代表什么——尤其当磁盘告警阈值设为 “剩余 free 判断时，可能永远收不到告警。
