c++oding="utf-8" ?>
std::filesystem::space 返回的 capacity 字段单位是字节（bytes），需手动换算为 gib 或 gb；传入路径必须为有效挂载点（如 windows 的 "c:" 或 linux 的 "/"），否则可能静默返回 0。
std::filesystem::space 返回的是什么单位？
std::filesystem::space 返回的是 std::filesystem::space_info 结构体，其中 capacity 字段单位是**字节（bytes）**，不是 KB 或 GB。直接打印会得到一个很大的整数，比如 500107862016，这其实是约 465.8 GiB —— 容易误以为调用失败或返回了错误值。
实操建议：
- 务必除以
1024.0 * 1024.0 * 1024.0转成 GiB（二进制单位），或除以1000.0 * 1000.0 * 1000.0转成 GB（十进制，厂商标称） - 注意
capacity可能为 0：当路径无效、无权限、或文件系统不支持容量查询时（如某些网络挂载、FAT32），space不抛异常，而是静默返回全 0 值 - 不要用
std::filesystem::current_path()当作磁盘根路径——它可能指向子目录，而space()是按所在卷/分区计算的，不是按目录层级
如何正确传入路径参数避免返回 0？
传错路径是 capacity 为 0 的最常见原因。Windows 下必须传盘符根路径（如 "C:\"），Linux/macOS 必须传挂载点（如 "/" 或 "/home"），不能传任意子目录（虽然有时也能工作，但不可靠）。
实操建议：
- Windows：用
R"(C:\)"或"C:/"（注意斜杠方向，std::filesystem内部会标准化） - Linux/macOS：用
"/"获取系统盘，"/mnt/data"获取挂载的第二块盘 —— 先确认挂载点真实存在（std::filesystem::exists(path)） - 跨平台写法可封装：
std::filesystem::path root = (std::filesystem::is_directory(path)) ? path : path.parent_path();，再取root.root_path()，但更稳妥是显式指定已知挂载点
std::filesystem::space 在不同平台的行为差异
行为差异主要体现在权限和挂载类型上，而非 API 接口本身。Windows 对 NTFS 卷返回准确值；Linux 下若挂载时用了 noatime 或 nodev 通常不影响，但 NFS、CIFS、exFAT 等可能返回 0 或过时值；macOS APFS 对快照卷可能报告逻辑容量而非物理可用空间。
实操建议：
- Linux 下若
space("/").capacity == 0，先运行df -h /对比验证是否是权限问题（比如容器内未挂载/proc） - 不要依赖
available或free字段做磁盘告警——它们受 reserved blocks（ext4）、purgeable space（APFS）影响，capacity才是总大小 - C++17 标准未强制要求实现
space，某些嵌入式 STL（如 older libstdc++ on old Android NDK）可能 stub 返回 0，编译时加-D_FILE_OFFSET_BITS=64并确认__cpp_lib_filesystem >= 201703L
最小可运行示例与常见编译陷阱
以下代码在 GCC 9+ / Clang 10+ / MSVC 2019+ 上可直接编译，但容易因链接或宏定义失败：
#include <filesystem>
#include <iostream><p>int main() {
try {
auto info = std::filesystem::space("C:"); // Windows
// auto info = std::filesystem::space("/"); // Linux/macOS
std::cout 1024.01024.0) </p>
<p>关键编译命令和坑：</p>
<ul>
<li>GCC/Clang：必须加 <code>-lstdc++fs</code>（GCC）或 <code>-lc++experimental</code>（Clang），否则链接报 <code>undefined reference to 'std::filesystem::space'</code>
</li>
<li>MSVC：需开启 <code>/std:c++17</code> 且默认启用，但若项目配置为 Unicode，确保字符串字面量用 <code>L"C:\"</code> 或启用 UTF-8 源码（<code>/utf-8</code>）</li>
<li>别忘了 <code>using namespace std::filesystem;</code> 简化调用，但注意避免和自定义 <code>space</code> 函数冲突</li>
</ul>
<p>真正麻烦的是权限和挂载状态 —— 代码跑通不代表值可靠，得结合 <code>df</code> 或 <code>GetDiskFreeSpaceEx</code> 交叉验证。</p></iostream></filesystem>C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
