shutil.disk_usage() 是跨平台获取磁盘剩余空间最可靠的标准库方案，返回 total/used/free 字节值，需传有效根路径（如 "C:" 或 "/"），并捕获 OSError 处理权限或路径异常。
用 shutil.disk_usage() 获取驱动器剩余空间最可靠
Windows、Linux、macOS 都支持，不用装额外包，也不用拼接命令或调用 subprocess。它返回的是 usage 命名元组，含 total、used、free 三个字段（单位字节）。
常见错误是传入相对路径或不存在的路径——shutil.disk_usage() 要求传入**有效目录路径**，不是盘符本身（比如 "C:" 在 Windows 上会失败）。正确做法是传 "C:\" 或 "/" 这类根路径。
- Windows 下传
"C:\\"（注意双反斜杠或原始字符串r"C:\"） - Linux/macOS 下传
"/"或挂载点如"/home" - 如果路径不存在或无权限，会抛出
OSError，需捕获处理
跨平台时怎么选路径参数？
不能硬写盘符，否则在 Linux 上直接报错。得先判断系统，再生成对应根路径：
import shutil
import os
<p>root = "C:\" if os.name == "nt" else "/"
try:
usage = shutil.disk_usage(root)
print(f"空闲: {usage.free // (1024**3)} GB")
except OSError as e:
print(f"获取失败: {e}")
注意：不要用 os.getcwd() 当参数——当前工作目录可能在某个子目录，不代表整个驱动器；也不要依赖 os.environ.get("SYSTEMDRIVE")，它只在 Windows 有且不一定反映实际挂载情况。
立即学习“Python免费学习笔记（深入）”；
为什么不用 os.statvfs() 或 psutil.disk_usage()？
os.statvfs() 是 Unix-only，Windows 不支持，跨平台代码里直接排除；psutil.disk_usage() 功能更强（比如支持按文件系统名查），但引入第三方依赖，纯标准库场景没必要。
性能上三者差异极小，但 shutil.disk_usage() 底层就是调用各平台原生 API（Windows 的 GetDiskFreeSpaceEx，Unix 的 statvfs），和 psutil 本质一致，只是封装更轻量。
- 如果项目已用
psutil做其他监控，复用它的disk_usage()没问题 - 如果只查磁盘空间，
shutil是零依赖最优解 -
psutil返回值单位也是字节，但字段名是total/used/free，和shutil一致，迁移成本低
单位换算和精度容易出错
所有 API 返回的都是字节，直接除 1024**3 得到 GiB（二进制 GB），但用户常误用 1000**3 算成十进制 GB，导致数值偏差约 7%。Windows 资源管理器显示的是 GiB，Linux df -h 默认也用二进制单位。
更稳妥的做法是用 humanize 库格式化，或自己控制小数位：
free_gb = usage.free / (1024**3)
print(f"{free_gb:.1f} GiB") # 注意是 GiB，不是 GB
另外，free 字段包含保留空间（如 ext4 的 5% root reserve），普通用户看到的“可用空间”可能略小于这个值——这是系统行为，不是 Python 的问题。
