装 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 无痛安装与避坑指南》第一章讲透的内容。先把自己的机器跑通,再谈创作。