应优先使用std::filesystem::space获取available字段判断可用空间，因其反映当前进程实际可写入字节数；需传入存在的目录路径（如"C:/"或"/"），规范路径、捕获filesystem_error异常，并注意跨平台差异及文件系统语义差异。
用 std::filesystem::space 获取分区剩余空间最直接
标准库 std::filesystem（C++17 起）提供了跨平台的磁盘空间查询能力，核心就是 std::filesystem::space 函数。它返回一个 std::filesystem::space_info 结构体，其中 available 字段即用户可用字节数（已扣除 root 预留空间），free 是未分配字节数（含 root 预留），通常你应该用 available。
常见错误是传入普通文件路径（如 "./data.txt"），这会导致获取的是该文件所在分区的空间，而非路径本身的“大小”——space() 只认挂载点或目录路径，不关心文件是否存在。
- 务必传入一个**存在的目录路径**，例如
"C:\"（Windows）、"/"或"/home"（Linux/macOS） - 路径末尾斜杠可省略，但不能是空字符串或非法路径，否则抛出
std::filesystem::filesystem_error - 在 Windows 上，驱动器根路径必须带冒号和反斜杠，如
"C:\"；用正斜杠"C:/"在某些标准库实现中可能失败
Windows 下注意驱动器路径格式与权限问题
Windows 不像 Unix 系统有统一根目录，每个驱动器（C:、D:）是独立挂载点。若传入 "C:"（无反斜杠），std::filesystem::space 行为未定义，多数实现会失败；传入 "C:\temp" 则能正确解析到 C 盘，但前提是该路径存在且可访问。
权限不足时（如访问系统保护目录），space() 仍可能成功——因为它查的是卷级信息，不依赖目录读取权限。但若路径指向网络驱动器且未连接，或符号链接指向不可达位置，则会抛异常。
立即学习“C++免费学习笔记（深入）”；
- 安全做法：先用
std::filesystem::exists(path)和std::filesystem::is_directory(path)校验路径有效性 - 捕获异常比预判所有失败场景更可靠：
try { auto s = std::filesystem::space(p); } catch (const std::filesystem::filesystem_error& e) { /* 处理 */ } - 不要依赖
std::filesystem::canonical来“规范化”驱动器路径，它对"C:"类路径效果不稳定
space_info 各字段含义与典型使用误区
std::filesystem::space_info 有三个字段：capacity（总容量）、free（空闲字节，含保留空间）、available（用户可用字节）。很多人误以为 free == available，但在 Linux/ext4 或 Windows NTFS 中，非 root 用户无法使用全部空闲空间（例如 ext4 默认预留 5% 给 root）。
实际业务中，判断“是否还能写入 1GB 文件”，应比较 s.available >= 1024ULL * 1024 * 1024，而不是 s.free。另外，这些值都是字节单位的 uintmax_t，做除法换算 GB 时记得用浮点或小心整数截断：
auto s = std::filesystem::space("/");
double gb_avail = static_cast<double>(s.available) / (1024.0 * 1024 * 1024);-
capacity可能小于物理磁盘大小（如有隐藏恢复分区或虚拟磁盘限制） - 某些容器环境或 FUSE 文件系统可能返回不准确值，
available是唯一有明确语义的字段 - 不要对不同路径多次调用
space()并缓存结果太久——磁盘使用是动态变化的
跨平台编译需确认标准库支持与编译选项
不是所有 C++17 编译器默认启用 std::filesystem。GCC 8+ 需链接 -lstdc++fs，Clang 9+ 同样需要该链接项；MSVC 2017 Update 3 起原生支持，无需额外链接。若编译报错 undefined reference to 'std::filesystem::space'，八成是忘了加链接参数。
另外，MinGW-w64 的旧版本（如 GCC 7.x）对 std::filesystem 支持不完整，space() 可能始终返回 0 或抛异常，建议升级到 GCC 9+ 或改用 GetDiskFreeSpaceEx（Windows）/ statvfs（POSIX）作为备选。
- CMake 中确保设置
set(CMAKE_CXX_STANDARD 17)，并为 GCC/Clang 添加target_link_libraries(your_target stdc++fs) - Clang macOS 默认使用 libc++，无需额外链接，但需确保 SDK 版本 ≥ 10.15（
statvfs实现较全） - 若项目需兼容 C++14，不要强行降级封装——直接调用平台 API 更稳妥，别为兼容性牺牲可靠性
真正容易被忽略的是：同一个路径在不同时间点调用 std::filesystem::space 返回值可能突变，尤其在低空间场景下，后台日志轮转、快照清理等操作会实时影响 available。业务逻辑里如果只检查一次就长期缓存，很可能后续写入失败。
