std::filesystem::space 返回 -1 通常因路径不可达或权限不足；windows 下需用 "c:" 而非 "c:"，linux/macos 需确保挂载点真实存在且非空；应先校验路径、捕获异常，并注意 available 与 free 在 windows 上分别对应用户可用和物理空闲空间。
std::filesystem::space 为什么返回 -1？
调用 std::filesystem::space 后，available 或 capacity 字段为 -1，通常不是代码写错了，而是路径不可达或权限不足。Windows 下传入 "C:"（不带反斜杠）会失败；Linux/macOS 下传入不存在的挂载点（如 "/mnt/usb"）且目录为空时，也可能触发 std::filesystem::space_error 异常或静默返回 -1。
实操建议：
- 始终使用完整路径：Windows 用
"C:\"，Linux/macOS 用"/"或"/home"等真实存在的目录路径 - 用
std::filesystem::exists()和std::filesystem::is_directory()提前校验路径有效性 - 捕获异常：包裹在
try/catch(const std::filesystem::filesystem_error& e)中，打印e.what()查具体原因 - 不要依赖返回值是否为 -1 来判断“无空间”，它更可能是“无法获取”——需结合错误类型区分
Windows 下 C: 盘剩余空间不准？
Windows 默认启用磁盘配额、卷影复制（VSS）、回收站保留策略，std::filesystem::space 返回的是「当前用户视角下可写入的字节数」，而非物理磁盘空闲量。例如：管理员账户能写的量 ≠ 普通用户账户能写的量；启用了配额限制后，available 可能远小于 free。
实操建议：
- 若需物理空闲量（忽略配额），改用 Windows API：
GetDiskFreeSpaceEx()，它返回lpFreeBytesAvailable（实际可用）、lpTotalNumberOfBytes（总容量）、lpTotalNumberOfFreeBytes（未分配总量）三个值 - 确认运行程序的用户权限：以管理员身份运行可绕过部分配额限制（但不推荐生产环境滥用）
-
std::filesystem::space的free字段在 Windows 上 ≈lpTotalNumberOfFreeBytes，而available≈lpFreeBytesAvailable—— 二者差值可能达 GB 级
跨平台获取根路径剩余空间的健壮写法
不同系统对“根路径”的理解不同：Linux 是 "/"，macOS 是 "/"（APFS 卷可能有多个），Windows 是 "C:"。硬编码会导致编译失败或运行时错误。
实操建议：
- 用
std::filesystem::current_path().root_path()获取当前所在卷的根路径（如 Windows 返回"C:\"，Linux 返回"/"） - 对多磁盘系统（如 Linux 挂载了
/home在独立分区），应传入目标目录路径而非盲目用根路径，例如查用户主目录：std::filesystem::space(std::filesystem::path{std::getenv("HOME")}) - 注意 C++17 标准要求编译器开启
-std=c++17且链接-lstdc++fs（GCC 9 以下）或-lc++fs（Clang）；MSVC 2017+ 默认支持，无需额外链接 - 简单示例：
try { auto space_info = std::filesystem::space(std::filesystem::current_path().root_path()); std::cout <h3>std::filesystem::space 的单位和精度陷阱</h3><p>返回值全是 <code>std::uintmax_t</code> 字节，但实际精度取决于底层文件系统。NTFS 返回的是 4KB 簇对齐后的值；ext4 通常精确到块大小（默认 4KB）；而某些网络文件系统（如 SMB/CIFS）可能只返回近似值，甚至缓存数秒。</p><p>实操建议：</p>- 别直接显示字节值——用户看不懂。转换时优先用
double计算 GiB：static_cast<double>(space_info.available) / (1024.0 * 1024.0 * 1024.0)</double> - 避免整数除法：写成
/ 1024 / 1024 / 1024会截断，丢失精度 - 如果用于容量预警（如“剩余不足 1GB 报警”），建议预留缓冲：比较时用
available ，防止临界抖动 - 频繁调用（如每秒轮询）没必要：磁盘空间变化缓慢，10–30 秒间隔足够；过度调用可能触发系统 I/O 限流（尤其在容器或云盘环境）
实际用的时候，最常被忽略的是路径合法性检查和异常捕获——很多人只写了
std::filesystem::space(path)就以为万事大吉，结果在 CI 环境或受限容器里静默返回 -1，连错在哪都不知道。 - 别直接显示字节值——用户看不懂。转换时优先用
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
