如何配置ComfyUI模型环境

配置 ComfyUI 的模型环境，核心目标就是：把模型文件放到正确的目录，并让 ComfyUI 能正常加载。下面按「从零到可用」的顺序一步一步说明（适用于 Windows / Linux，macOS 类似）。

一、先确认 ComfyUI 已安装

如果你还没装 ComfyUI，推荐用官方方式：

1️⃣ 安装依赖

• Python ≥ 3.10
• Git
• CUDA（NVIDIA 显卡，可选但强烈推荐）

2️⃣ 克隆 ComfyUI

git clone https://github.com/comfyanonymous/ComfyUI
cd ComfyUI

3️⃣ 安装依赖

python -m pip install -r requirements.txt

4️⃣ 启动 ComfyUI

python main.py

浏览器打开：

http://127.0.0.1:8188

二、ComfyUI 模型目录结构（重点）

ComfyUI 的模型目录是 固定的，模型放错位置会导致无法加载。

ComfyUI/
├── models/
│   ├── checkpoints/        # 主模型（SD1.5 / SDXL / FLUX 等）
│   ├── loras/              # LoRA 模型
│   ├── controlnet/         # ControlNet 模型
│   ├── vae/                # VAE 模型
│   ├── embeddings/         # Textual Inversion（可选）
│   ├── upscale_models/     # 超分模型（ESRGAN 等）
│   ├── clip/               # CLIP 模型（少见）
│   └── diffusers/          # Diffusers 格式（可选）

✅ 90% 的问题都是模型放错目录

三、常用模型类型 & 放置位置

1️⃣ 检查点模型（Checkpoints）

最常见

• 文件格式：
• .safetensors
• .ckpt
• 放置位置：

ComfyUI/models/checkpoints/

示例：

checkpoints/
├── sd_xl_base_1.0.safetensors
├── realisticVisionV60B1.safetensors

2️⃣ LoRA 模型

• 文件格式：
• .safetensors
• 放置位置：

ComfyUI/models/loras/

3️⃣ VAE

• 文件格式：
• .safetensors
• 放置位置：

ComfyUI/models/vae/

4️⃣ ControlNet

• 文件格式：
• .safetensors
• 放置位置：

ComfyUI/models/controlnet/

5️⃣ 超分 / Upscale 模型

• 如 ESRGAN、RealESRGAN
• 放置位置：

ComfyUI/models/upscale_models/

四、模型从哪里下载？

✅ 推荐来源

⚠️ 优先下载 .safetensors，比 .ckpt 更安全

五、ComfyUI 中如何加载模型？

1️⃣ 检查点加载

节点路径：

Load Checkpoint

2️⃣ LoRA 加载

节点路径：

Load LoRA

3️⃣ VAE 加载

节点路径：

Load VAE

如果模型没出现：

• 确认目录正确
• 重启 ComfyUI
• 检查文件名是否含特殊字符

六、常见错误 & 解决方法

❌ 模型不显示

✅ 检查：

• 是否放在 models/checkpoints
• 是否 .safetensors
• 是否重启 ComfyUI

❌ CUDA / 显存不足

✅ 解决：

• 使用 --lowvram 启动：

python main.py --lowvram

• 或 --medvram

❌ 模型加载报错

✅ 常见原因：

• SD1.5 模型用在 SDXL 流程
• VAE 不匹配
• LoRA 与 base model 不兼容

七、推荐基础环境配置（示例）

✅ 稳定组合

• SDXL：
• sd_xl_base_1.0.safetensors
• sd_xl_vae.safetensors
• SD1.5：
• Realistic Vision
• v1-5-pruned-emaonly.safetensors

八、进阶（可选）

• 使用 ComfyUI-Manager 管理模型 & 插件
• 软链接模型（避免重复存储）
• 多模型共享目录配置

如果你愿意，我可以：
✅ 给你一个 具体模型 + 工作流示例（SDXL / FLUX）
✅ 帮你排查 某个模型为什么加载失败
✅ 给你 Windows / Linux 的完整安装脚本
你可以直接说：

我用的是 Windows / Linux，显卡是 RTX 3060，想跑 SDXL 还是 FLUX