知仓学习社知仓学习社
磁盘空间不足 / 下载解压中断导致安装与启动失败 / 全站资源搜索
搜索 更新 2026-10-02
报错 008 安装、启动与运行环境 有来源可查

磁盘空间不足 / 下载解压中断导致安装与启动失败

报错原文（原样） 
[2025-09-18 14:58:57.265] [info] x Failed to download torch==2.8.0+cu128
|-> Failed to extract archive: torch-2.8.0+cu128-cp312-cp312-win_amd64.whl
|-> I/O operation failed during extraction
检索关键词 Failed to extract archive、I/O operation failed during extraction、Failed to download distribution due to network timeout、磁盘空间不足、解压不完整、disk space、No space left
先看这一句 安装或启动过程中报解压/写入失败，或启动时提示依赖包缺失、目录不完整；磁盘剩余空间很少时尤为明显。
适用版本 全版本通用 · 核实日期 2026-09-26 · 状态 已核实
适用环境：ComfyUI Desktop、Windows 便携版、全部主流环境

现象与触发场景

常见触发场景：

  • 系统盘剩余空间不足时安装桌面版
  • 网络不稳定导致 wheel 下载/解压中断
  • 便携包 7z 解压到一半被中断

根因

  • torch wheel 体积很大，安装过程需要先下载再解压落盘，空间不足或写入失败会直接中断在该阶段
  • 官方桌面版 FAQ 给出的空间要求是每个独立安装至少 4.85 GB，官方故障排除页则建议安装时至少预留 15GB 磁盘空间
  • uv 的中央缓存损坏后，后续所有安装都会在同一处反复失败

解决步骤

已按「最可能有效」排序。请从上往下做，每做完一步用「验证」确认，不要一次改五处。

  1. 确认系统盘剩余空间并清理
    官方要求单个安装约 4.85 GB、安装过程建议预留 15GB；把这些空间腾出来后再重试，避免在解压阶段再次失败。
  2. 清理 uv 缓存后重新安装
    官方维护者 filtered 在排查同类安装失败时给出了清理系统 uv 缓存的做法：删除 uv 目录会触发重新下载较大的 Python 文件，但能修掉被写坏的缓存。
    Remove-Item -Recurse $env:APPDATA\uv
  3. 换稳定的网络/镜像重试
    报错指向 network timeout 时属于下载问题；中国大陆网络环境下官方更新文档建议配置代理，或用境内镜像安装依赖。
    pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

验证是否修好

安装流程走完不再出现 Failed to extract archive；启动日志里所有核心依赖都能导入，界面能打开且模板/前端正常。

补充说明

error_text 取自官方论坛帖原文（安装日志节选）。

来源

按可信度排列：官方 issue / 官方文档 > 节点仓库 issue > 社区帖 > 中文社区文章。 链接以纯文本给出（本站不做站外跳转），需要核对时请自行复制到浏览器打开。
  1. [22] （官方论坛）　Unable to start ComfyUI Desktop v0.4.72　https://forum.comfy.org/t/unable-to-start-comfyui-desktop-v0-4-72/3800
  2. [23] （官方文档）　Comfy Desktop FAQ - ComfyUI　https://docs.comfy.org/installation/desktop/faq
  3. [24] （官方文档）　如何更新 ComfyUI - ComfyUI（依赖更新故障排除）　https://docs.comfy.org/zh/installation/update_comfyui

这条报错要用到的东西

按本条报错所属的类别（安装、启动与运行环境）列出站内相关的下载包与板块入口。 它们不是「必须下载才能修好」，而是这一类问题里最常要动到的东西；具体怎么做，以上面的解决步骤为准。

环境与依赖配置包依赖版本组合清单 / 环境自检脚本说明 待挂载
节点库装扩展之后出问题的，多半是节点依赖没装全 板块

同一类别的其他条目

【001】双击 run_nvidia_gpu.bat 窗口一闪而过：c10.dll 缺失，需要安装 VC++ 运行库 有来源 【002】端口 8188 被占用：Address already in use / 上次的 ComfyUI 进程没退干净 有来源 【003】torch 加载失败：OSError [WinError 1114] 动态链接库(DLL)初始化例程失败 c10.dll 有来源 【004】便携版找不到内嵌 Python / 路径不对：'python' 不是内部或外部命令、系统找不到指定的路径 有来源 【005】用户名/路径含非 ASCII 字符或空格导致安装与启动失败 有来源
这个解法对你有效吗 记录只存在你自己的浏览器里，不需要注册账号。

返回报错库