std::filesystem::space() 返回的 available 字段才是普通进程实际可用的剩余空间，因它已扣除系统为 root 保留的空间；使用前须检查路径有效性并用 std::uintmax_t 接收结果以防溢出。
std::filesystem::space 是获取磁盘空间信息最直接的方式，但它返回的是 space_info 结构体，不是单个“剩余空间”数值——你得自己取 available 字段。
为什么 space() 返回的 available 比 free 更常用
操作系统对普通用户和 root 用户的磁盘保留策略不同：free 表示“所有未分配空间”，available 扣除了系统为 root 保留的部分（通常是 5%），这才是普通进程实际能写入的空间上限。
-
available是你做磁盘容量判断时该用的字段，比如“是否还能存下这个文件” -
free在调试或监控 root 权限服务时可能有用，但多数应用不该依赖它 -
capacity是总容量，不含文件系统元数据开销（如 ext4 的 superblock、inode table），所以略小于磁盘物理大小
调用 std::filesystem::space() 前必须检查路径有效性
传入无效路径（如空字符串、不存在目录、权限不足）会抛出 std::filesystem::filesystem_error，不处理会导致程序崩溃。
- 推荐先用
std::filesystem::exists()和std::filesystem::is_directory()预检 - 或者直接
try/catch捕获filesystem_error，并检查.code().value()是否为EPERM或ENOENT - 注意：传入文件路径（非目录）也能成功，
space()总是返回该文件所在卷的信息
space_info 各字段单位统一为字节，但要注意溢出风险
返回值是 std::uintmax_t，在 32 位系统上可能是 uint32_t，而现代硬盘容量轻松超 4TiB——这时 capacity 可能被截断。
立即学习“C++免费学习笔记（深入）”；
- 确保编译器和标准库支持完整
uintmax_t（GCC 9+、Clang 7+、MSVC 2019 16.8+ 均满足） - 避免用
int或long接收，应始终用std::uintmax_t或std::size_t（后者在 64 位系统安全） - 示例安全用法：
auto info = std::filesystem::space("/home");<br>std::uintmax_t avail_bytes = info.available;
真正容易被忽略的是：Windows 下若传入网络路径（如 \\server\share），space() 可能返回 (0, 0, 0) 而不报错；Linux 下挂载点被卸载后也可能静默失效。这类边界情况得靠定期重查 + 业务层兜底判断。
