2025年——ComfyUI_优化HuggingFace连接与缓存管理的实用技巧

1. 为什么你的ComfyUI总是卡在“Downloading”？

如果你玩ComfyUI有一段时间了，尤其是用上了那些功能强大的自定义节点，那你肯定对这个场景不陌生：流程跑得好好的，突然就卡住了，节点上显示一个令人心焦的“Downloading”，进度条半天不动，甚至直接报错“Connection Error”。这时候，你大概率是遇到了HuggingFace连接问题。

HuggingFace（简称HF）现在几乎是AI开源模型的“中央仓库”，从Stable Diffusion的变体到各种ControlNet、LoRA，再到语音、文本模型，很多ComfyUI插件都依赖它来获取必要的预训练模型或配置文件。但问题在于，HF的服务器在海外，对于国内用户来说，直接访问的体验就像在晚高峰挤地铁——慢，而且经常挤不上去。这还不是最糟的，更让人头疼的是，这些模型动辄几个GB，默认都下载到你的C盘用户目录下的.cache文件夹里。用不了多久，你的C盘就会亮起红灯，或者当你把整个ComfyUI环境迁移到另一台电脑或移动硬盘时，你会发现所有模型都得重新下载一遍，之前的等待全都白费了。

所以，优化HF连接和管理缓存，根本不是“锦上添花”，而是保证ComfyUI工作流能顺畅运行的“雪中送炭”。今天，我就结合自己折腾了无数次的实战经验，给你分享一套在2025年依然管用的、从连接加速到缓存管理的完整优化方案。咱们不聊虚的，直接上干货，让你彻底告别下载等待和C盘焦虑。

2. 告别龟速：一键切换HF镜像，让下载飞起来

最直接、最有效的提速方法，就是把ComfyUI连接HF的地址，从官方的huggingface.co切换到国内的镜像站。原理很简单，就像你在国内网购，从海外仓发货要等一个月，但从国内保税仓发货可能三天就到了。镜像站就是把HF上的热门模型同步到了国内的服务器上，下载速度能有质的飞跃。

目前最稳定、最常用的镜像站是 hf-mirror.com。下面我介绍两种设置方法，一种“一劳永逸”，一种“灵活机动”，你可以根据习惯选择。

2.1 方法一：修改ComfyUI源代码（推荐，永久生效）

这是最根本的解决方法，一次设置，终身受益。很多教程会让你去改系统环境变量，但那会影响你电脑上所有使用HF库的程序。我们只针对ComfyUI进行优化，更精准。

1. 找到关键文件：进入你的ComfyUI安装目录。如果你用的是整合包，它可能叫 ComfyUI_windows_portable 之类的。我们需要找到ComfyUI的Python入口文件。对于大多数版本，这个文件就是根目录下的 main.py。但有些整合包为了简化启动，可能会有一个 run_nvidia_gpu.bat 或 run_cpu.bat 这样的批处理文件，它们最终也是调用 main.py。所以，我们的目标就是 main.py。

2. 添加环境变量代码：用记事本（Notepad）或任何代码编辑器（如VSCode、Notepad++）打开 main.py 文件。不要直接双击，右键选择“打开方式”然后选编辑器。

   滚动到文件的最开头，在所有的 import 语句之前，添加以下两行代码：

   import os
   os.environ['HF_ENDPOINT'] = 'https://hf-mirror.com/'
   

   为什么要在最开头？因为Python程序在启动时，会按顺序执行代码。我们必须确保在ComfyU