报错 027 依赖缺失与自定义节点安装失败有来源可查

报错 ImportError: cannot import name 'cached_download' from 'huggingface_hub'（diffusers 与新版 huggingface_hub 不兼容）

报错原文（原样）

File "D:\ComfyUI\Lib\site-packages\diffusers\utils\dynamic_modules_utils.py", line 28, in <module>
from huggingface_hub import cached_download, hf_hub_download, model_info
ImportError: cannot import name 'cached_download' from 'huggingface_hub' (D:\ComfyUI\Lib\site-packages\huggingface_hub\__init__.py)
Cannot import D:\ComfyUI\custom_nodes\ComfyUI_MagicClothing module for custom nodes: cannot import name 'cached_download' from 'huggingface_hub' (D:\ComfyUI\Lib\site-packages\huggingface_hub\__init__.py)

检索关键词 cannot import name 'cached_download' from 'huggingface_hub'、cached_download、hf_hub_download、dynamic_modules_utils.py、huggingface_hub 0.26、Cannot import、IMPORT FAILED

先看这一句 安装依赖 diffusers 的节点（MagicClothing、部分换装/Flux 类节点）后，启动日志报 cannot import name 'cached_download'，该节点目录 IMPORT FAILED；用户常反复重装依赖仍无效。

适用版本 仅当环境里 diffusers 较旧（仍在导入 cached_download）且 huggingface_hub >= 0.26 时出现；新版 diffusers 已改用 hf_hub_download · 核实日期 2026-09-26 · 状态已核实

适用环境：Windows 便携版、秋叶/绘世整合包、ComfyUI Desktop、Linux + 云 GPU、Docker/服务器

现象与触发场景

常见触发场景：

某次装别的节点时把 huggingface_hub 升到了 0.26 及以上，而环境里的 diffusers 仍是旧版
中文整合包默认带了较新的 huggingface_hub，与包内旧版 diffusers 冲突
只更新了节点，没有更新 diffusers

根因

huggingface_hub 0.26 起移除了 cached_download，改用 hf_hub_download；旧版 diffusers 的 dynamic_modules_utils.py 仍在导入被删掉的名字
diffusers 属于共享依赖，被多个节点共用，单独升级它会牵动其它节点，所以很多整合包长期停留在旧版

解决步骤

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

改掉 diffusers 里那一行导入（issue 报告者推荐的方案）
按报错给出的路径打开 diffusers\utils\dynamic_modules_utils.py，把第 28 行的 `from huggingface_hub import cached_download, hf_hub_download, model_info` 改成 `from huggingface_hub import hf_hub_download, model_info`（即删掉 cached_download 这一项），保存后重启 ComfyUI。这不会动任何包版本，风险最小。
或者降级 huggingface_hub 到 0.25.x
如果不想改第三方库文件，可把 huggingface_hub 降到 0.25.0。注意这条路可能连带重装其它依赖，issue 报告者本人也提示“重装可能让一些依赖被一起改动，于是进入新一轮依赖不匹配的排查”，所以降级后要复查其它节点是否仍能加载。
..\..\python_embeded\python.exe -m pip install huggingface_hub==0.25.0
升级 diffusers 到已适配新 API 的版本
更彻底的做法是把 diffusers 升到不再导入 cached_download 的版本，但 diffusers 是被多个节点共享的重依赖，升级前先导出当前清单并备份环境，升级后逐个验证依赖它的节点。
..\..\python_embeded\python.exe -m pip freeze > pip-freeze-backup.txt

验证是否修好

重启 ComfyUI，日志中不再出现 cannot import name 'cached_download'，该节点目录不再 IMPORT FAILED，节点能在界面里正常添加并执行。

补充说明

该 issue 由报告者本人给出并验证，措辞为“That's all. Magic Clothing can now be loaded.”。若你用的是 Manager 管理的环境，改文件后再次“修复依赖”可能把 diffusers 覆盖回去，需重新检查。

来源

按可信度排列：官方 issue / 官方文档 > 节点仓库 issue > 社区帖 > 中文社区文章。链接以纯文本给出（本站不做站外跳转），需要核对时请自行复制到浏览器打开。

[75] （节点仓库 issue）　cannot import name 'cached_download' from 'huggingface_hub' - Magic Cl　https://github.com/frankchieng/ComfyUI_MagicClothing/issues/80
[76] （社区）　ImportError: cannot import name 'cached_download' from 'huggingface_hu　https://stackoverflow.com/questions/79374322/importerror-cannot-import-name-cached-download-from-huggingface-hub

这条报错要用到的东西

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

常用节点速查包常用节点参数小抄 / 常见连法示意图待挂载

节点库按用途找节点仓库，附适配模型与下载量板块

同一类别的其他条目

【023】报错 No module named 'insightface'（IPAdapter 人脸加载器 / ReActor 换脸节点不可用）有来源【024】一个节点包报错导致 / 或看似导致所有自定义节点加载中断（Cannot import ... custom_nodes）有来源【025】报错 No module named 'cv2'（controlnet_aux / WanVideoWrapper 等节点导入失败）有来源【026】报错 ImportError: DLL load failed while importing onnxruntime_pybind11_state（缺 Visual C++ 运行库 / onnxruntime 版本不匹配）有来源【028】工作流加载后提示缺少节点 / 节点显示红色（Warning: Missing Node Types）有来源

这个解法对你有效吗 记录只存在你自己的浏览器里，不需要注册账号。

返回报错库