std::filesystem::space返回路径所在挂载点的文件系统空间信息,而非路径本身剩余空间;它底层调用statvfs或GetDiskFreeSpaceEx,作用域限于挂载单元,故传入子路径仍得所在分区整体数据。

用 std::filesystem::space 获取分区剩余空间时,为什么总是返回根目录信息?
因为 std::filesystem::space 接收的是路径,但它实际查询的是该路径所在**挂载点(mount point)** 的文件系统统计信息,不是路径本身的“剩余空间”。如果你传入 "./data" 或 "/home/user/docs",它返回的是 /home 分区(或其所在挂载点)的 capacity/free/available,而非子目录的独占空间。
常见错误是误以为它能递归计算目录占用,其实它底层调用的是 POSIX statvfs()(Linux/macOS)或 GetDiskFreeSpaceEx()(Windows),只和挂载点绑定。
- 必须传入一个**实际存在于目标分区上的有效路径**(哪怕只是
"/"、"/boot"、"/mnt/data") - 若路径不存在或无权限访问,
std::filesystem::space会抛出std::filesystem::filesystem_error -
available字段才是用户真正可用的剩余字节数(已扣除 root 预留空间);free是所有非 root 用户可用量;capacity是总容量
/proc/mounts
- 优先读取
/proc/self/mounts,比/proc/mounts更稳定(避免被其他进程修改) - 跳过以
none、tmpfs、devtmpfs、debugfs等开头的fs_type - 挂载点路径需用
std::filesystem::path标准化(处理..、重复/),再传给space() - 某些挂载点可能无读权限(如
/boot/efi),需捕获异常并跳过
std::vector<:pair std::string>> get_mount_points() {
std::vector<:pair std::string>> mounts;
std::ifstream f("/proc/self/mounts");
std::string line;
while (std::getline(f, line)) {
std::istringstream iss(line);
std::string dev, mp, fstype;
iss >> dev >> mp >> fstype;
if (fstype == "ext4" || fstype == "xfs" || fstype == "btrfs" ||
fstype == "ntfs" || fstype == "vfat") {
mounts.emplace_back(mp, fstype);
}
}
return mounts;
}</:pair></:pair>
Windows 下怎么拿到每个驱动器盘符的剩余空间?
Windows 没有“挂载点”概念,而是以驱动器盘符(C:、D:)为单位。直接用 std::filesystem::space 传入盘符根路径即可,但要注意格式:必须带冒号和反斜杠,即 "C:\",不能写成 "C:" 或 "C:/"(后者在 Windows 上可能被解释为相对路径,导致查到当前工作目录所在盘符)。
-
"C:\\"是最安全的写法(双反斜杠转义后为单个) - 遍历所有可能盘符可调用
GetLogicalDrives()(Windows API),或硬编码A–Z并用std::filesystem::exists("X:\")过滤无效盘符 - NTFS 卷支持压缩/配额,
available已自动反映用户配额限制
std::filesystem::space
- 永远检查异常,不要假设路径一定可访问
- 对用户展示时,优先用
available而非free,它才是真正能写的字节数 - 若需精确到目录级磁盘使用(非剩余空间),得用
std::filesystem::recursive_directory_iterator手动累加,和space()完全是两回事
C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!











