装 ComfyUI 这件事,教程里往往一句话带过:“git clone 然后跑起来”。真机上,卡住新手的从来不是 ComfyUI 本身,而是它前面的环境。下面 5 个坑,是我在一台无管理员权限、国内网络、6G 显存的机器上一一踩过并填平的。

坑 1:没有管理员权限,软件装不进 Program Files

很多教程让你把东西装到 C:/Program Files,或者让你“以管理员身份运行”。沙箱环境里这两样都没有。解法很简单:全部装到用户目录或 D 盘,用用户级 Python(python -m venv 建在任意你有写权限的目录),不碰系统目录,就不需要任何提权。

坑 2:GitHub 下载被墙 / 超时

git clone 十次有八次卡在 0%。国内网络的通用替代通道:

  • 源码用 ghfast.top 或 codeload.github.com 的 zip 包直接下;
  • 依赖走 npmmirror 和清华 pip 镜像;
  • 模型权重走国内可直连的托管,不硬刚 GitHub Release。

坑 3:显存爆掉,模型加载就 OOM

6G 显存(比如 GTX 1660 Ti)跑 SD1.5 流畅,跑 SDXL 要开 --lowvram,跑 Flux 基本吃力。对策:先用 SD1.5 把流程跑通,再谈升级;启动参数里加低显存模式,模型选对精度。

坑 4:Python 版本不对,一启动就报语法错

系统自带 Python 太老或太新都会出事。建一个独立的虚拟环境,锁定到项目要求的版本,所有依赖装进这个环境,互不污染。这套动作课程第 2 章有逐行讲解。

坑 5:自定义节点装完,主程序反而启动不了

节点依赖冲突是头号元凶。用 ComfyUI Manager 装节点、装完看启动日志、冲突的依赖用虚拟环境隔离。不要图省事手动往 site-packages 里塞包。

这 5 个坑对应的完整操作,就是《ComfyUI 无痛安装与避坑指南》第一章讲透的内容。先把自己的机器跑通,再谈创作。