c++oding="utf-8" ?>
应通过系统api获取临时目录路径后查询所在磁盘/文件系统的可用空间:windows用gettemppath+getdiskfreespaceex(需先提取盘符),posix用getenv("tmpdir")/realpath+statvfs(用f_bavail*f_frsize),并校验权限与错误。

Windows下用GetTempPath和GetDiskFreeSpaceEx组合获取临时目录所在磁盘的剩余空间
C++标准库不提供直接查询“临时文件夹大小”的接口——因为临时文件夹本身没有固定大小限制,真正有意义的是它所在磁盘的可用空间。Windows平台最可靠的做法是先拿到临时路径,再查该路径所在卷的空闲字节数。
常见错误是直接对GetTempPath返回的路径调用GetDiskFreeSpaceEx:如果路径是符号链接或重定向(比如通过TEMP环境变量指向D: emp),必须先用GetFullPathName或PathStripToRoot提取盘符,否则可能查错驱动器。
-
GetTempPath返回的是字符串缓冲区长度,不是路径长度,需传入足够大的缓冲区(如MAX_PATH) - 务必检查
GetTempPath返回值是否为0或大于缓冲区大小,否则路径被截断 -
GetDiskFreeSpaceEx第三个参数(lpFreeBytesAvailable)才是用户可写入的剩余空间,不要误用lpTotalNumberOfBytes
Linux/macOS用std::getenv("TMPDIR")配合statvfs查挂载点可用空间
POSIX系统没有统一的“系统临时目录大小”概念,/tmp可能位于内存文件系统(tmpfs)、单独挂载分区,或只是根分区下的子目录。关键是要定位到statvfs能作用的挂载点根路径,而不是单纯查/tmp目录本身的st_size(那只是当前目录下文件总大小,毫无意义)。
典型陷阱是直接对getenv("TMPDIR")结果调用statvfs:如果TMPDIR未设置,fallback到"/tmp",但"/tmp"可能是bind mount或symlink,statvfs需要真实挂载路径。应先用realpath展开路径,再用statvfs查其所在文件系统的f_bavail(可用块数)乘以f_frsize(基本块大小)。
-
statvfs返回结构体中f_bavail * f_frsize才是普通用户实际可用字节数,f_bfree包含root保留空间 - 若
realpath失败(如路径不存在),应回退到"/"并记录警告,避免程序崩溃 - macOS上
statvfs可用,但某些容器环境(如Docker)中/tmp挂载点可能不可见,需容忍ENOTCONN等错误
跨平台封装时别硬编码"C:\Windows\Temp"或"/tmp"
手动拼接路径是最大隐患:Windows的临时目录由GetTempPath动态决定(可能受TEMP/TMP环境变量、组策略影响),Linux下/tmp可能被systemd-tmpfiles清理或挂载为noexec。任何假设路径字符串的代码都会在非默认配置下失效。
正确做法是优先调用系统API获取路径,仅在API不可用时才fallback到环境变量。例如Windows下GetTempPath失败时再读GetEnvironmentVariable("TEMP");Linux下getenv("TMPDIR")为空时才用"/tmp",且必须验证该路径存在且可写(access(path, W_OK))。
- 不要用
std::filesystem::temp_directory_path()替代系统API——它在MSVC 19.29+才完整支持,且某些libc++版本会忽略TMPDIR - 路径字符串末尾可能带斜杠,
statvfs或GetDiskFreeSpaceEx对斜杠不敏感,但拼接子路径时需处理重复分隔符 - 权限检查比路径存在更重要:即使
/tmp存在,若挂载为noexec,nosuid,nodev,应用仍可能因无法创建文件而失败
注意单位换算和整数溢出风险
所有API返回的字节数都是ULARGE_INTEGER(Windows)或uint64_t(POSIX),直接转成int或size_t会导致高位截断。尤其在计算GB时,用bytes / (1024ULL * 1024ULL * 1024ULL)而非bytes / 1073741824——后者是int常量,32位系统会溢出。
更隐蔽的问题是磁盘报告的“可用空间”可能随I/O实时变化,且内核预留空间(如ext4的5% reserved blocks)已计入f_bavail,无需额外扣除。但某些tmpfs挂载(如tmpfs -o size=2G)的限制是硬性的,超出会直接write失败,这时statvfs的f_bavail就是唯一可信指标。
- 显示给用户时建议用IEC单位(KiB/MiB/GiB),避免混淆十进制/二进制前缀
- 若需预留缓冲空间(如预分配大文件),应在可用空间基础上减去至少10MB,防止其他进程瞬时占用
- Windows下
GetDiskFreeSpaceEx可能因UAC虚拟化重定向而返回错误值,确保进程以正确权限运行
实际写的时候,临时目录的“大小”从来不是静态值——它取决于磁盘配额、挂载选项、内核参数和并发写入状态。最稳妥的策略永远是:每次需要写入前,用对应API查一次可用空间,并准备好errno == ENOSPC或GetLastError() == ERROR_DISK_FULL的降级逻辑。
C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!











