No space left on device：区分模型、临时目录与输出盘

现象与适用范围

下载模型、解压依赖或保存图片视频时出现磁盘空间错误。即使目标输出盘还有空间，下载缓存、系统临时目录、容器可写层或另一个挂载点仍可能已满。

检索用原文或片段（具体编号、数值和文件名随环境变化）：

No space left on device
ENOSPC
Errno 28

已核对的依据

Python errno 将 ENOSPC 定义为设备空间不足。Hub 下载具有缓存与本地目录概念，VideoHelperSuite 也区分临时和输出保存位置，因此应根据失败路径查空间，而不只查看一个盘符。 P07 P11 R02 GNU df 手册 Docker 存储文档

需要区分的情况

1. 权重缓存与用户指定目录位于不同文件系统，某一个空间不足。

2. 视频中间帧、编码临时文件或连续批量输出快速占用磁盘。

3. 容器可写层或挂载卷可能先于宿主机其他文件系统耗尽；在 Linux 上，inode 用量还需单独检查。

建议的操作顺序

以下顺序是基于上述资料整理的诊断方案，不代表上游已经为你的环境确认了原因。

第 1 步。 从错误日志提取失败路径；只保留目录类别，公开求助时删去用户名和敏感文件名。

第 2 步。 分别检查模型目录、缓存、临时目录、输出目录所属文件系统的空间与配额。

第 3 步。 停止写入，备份需要保留的产物，再通过应用或平台支持的方式清理明确不用的文件。不要递归删除整个环境。

第 4 步。 调整输出或缓存位置后，用一张图或短片测试新路径确实生效；确认断点下载文件完整再加载。

可复制的检查命令

使用 GNU coreutils 的 Linux 可先只读检查实际报错路径所在文件系统；Windows 请用系统存储工具检查对应盘或挂载卷：

df -h
# 查看 inode 用量；并非所有文件系统都有固定 inode 上限
df -i

如何判断处理有效

写入小文件与目标任务均成功，失败路径的可用空间足够容纳预计中间数据，而非只有最终文件大小。

注意事项与尚未确认的部分

Linux 的 inode 耗尽也可能表现为无法写入，不能仅看 GB 数量。任何清理操作都应由用户确认需要保留的数据。

资料核对日期：2026-09-21。本站未执行此工作流，未进行 GPU、最低显存或耗时测试。

原始资料

• P07 · Python errno。核对：2026-09-21。
• P11 · Hugging Face Hub download guide。核对：2026-09-21。
• R02 · VideoHelperSuite README。核对：2026-09-21。
• GNU df 手册。核对：2026-09-25。
• Docker 存储文档。核对：2026-09-25。

相关排查与操作

• 下载模型时必须记住的四项：仓库、修订、路径与校验依据
• 视频导出失败、黑屏或时长不对：检查编码与帧率链路