📚

ComfyUI Tutorial

下载模型 提示词 Flux工作流 3D工作流 ControlNet控制 音频工作流 视频工作流 LTX工作流 Upscale工作流 ComfyUI管理器 Wan2.2
/下载模型

如何从 Civitai 下载模型并加载到 ComfyUI

一份在 ComfyUI 中安装与使用模型、提升 AI 图像生成效果的分步教程。本文会介绍两种不同方式（Civitai 和 Hugging Face），两种方法思路相近，但存在一些细节差异。

简介

Civitai 是目前主流的 AI 模型分享平台。本教程将一步步带你从 Civitai 查找、下载模型，并正确加载到 ComfyUI 中，保证模型兼容与最佳运行效果。

准备工作

开始前，请确保你已具备：

  • 可正常运行的 ComfyUI（如未安装，可参考 ComfyUI 安装教程）
  • 稳定的网络（模型大小从 1GB 到 10GB 以上不等）
  • 足够的存储空间（建议预留 20GB 以上空间存放模型）
  • 了解 ComfyUI 基本文件结构

开始之前

本节主要以 z-image-turbo 这类 LoRA 模型为例。如果你需要下载其他类型模型，如 LoRA、Embedding 等，方法基本一致。

第一部分：从 Civitai 下载模型

从 Civitai：进入网站并搜索模型

  1. 打开浏览器，访问 Civitai.com
  2. 使用顶部搜索栏，按名称（如 Realistic Vision、DreamShaper）或分类查找模型
  3. 使用左侧边栏筛选结果：
    • Model Type（模型类型）：选择模型类型（Checkpoint、LoRA、ControlNet、Embedding 等）
    • Base Model（底模型）：选择兼容版本（如 SD 1.5、SDXL 1.0，版本即使只差少量字符也不兼容）
    • 阅读描述（Description），了解使用场景、优势与推荐提示词
    • 查看示例图（Sample Images），确认模型出图风格
    • 留意文件大小（File Size），确保有足够存储空间

从 Hugging Face：进入网站并搜索模型

  1. 打开浏览器，访问 Hugging Face
  2. 使用顶部搜索栏，按名称（如 z-image-turbo_fp8）或分类查找模型
  3. 进入 files and versions 板块，选择要下载的模型文件

补充说明：

  1. 你可以从 Hugging Face 下载 VAE、test_encoders 等模型，但不要下载 transformers 文件夹里的 diffusion 模型：它们未经过量化，体积巨大，且在 ComfyUI 中不兼容。
  2. 下载社区提供的量化版本模型。在页面右侧找到 model tree 区域，选择量化模型链接，里面大多是 GGUF 格式。

第二部分：将模型加载到 ComfyUI

步骤 1：找到 ComfyUI 模型目录

首先找到你的 ComfyUI 安装文件夹，默认模型存放路径如下：

模型类型ComfyUI 路径
Checkpoints（高阶模型基本不再使用）ComfyUI/models/checkpoints/
Diffusion 模型ComfyUI/models/diffusion_models/
文本编码器ComfyUI/models/text_encoder_models/
LoRAComfyUI/models/lora/
ControlNetComfyUI/models/controlnet/
VAEComfyUI/models/vae/
放大模型ComfyUI/models/upscale_models/

:::tip 整理建议 在每个目录里新建子文件夹（如 lora/character/、controlnet/pose/），方便模型增多后管理，且软件仍能正常读取。 :::

步骤 2：安装下载好的模型

  1. 找到下载的模型文件（通常在浏览器的“下载”文件夹）
  2. 复制或移动文件到对应的 ComfyUI 模型目录（例如 LoRA 文件 → models/lora/）
  3. 除非你清楚后果，否则不要重命名文件（部分模型依赖特定命名规则）
  4. 压缩包文件（.zip、.rar）：
    • 先解压
    • 将解压后的文件（而非压缩包本身）放入模型目录

步骤 3：重启 ComfyUI

  1. 完全关闭 ComfyUI
  2. 重新打开，让软件检测新模型
  3. 等待 ComfyUI 加载——启动时会自动扫描模型

第三部分：常见问题排查

问题 1：模型在 ComfyUI 中不显示

  • 确认模型放在正确目录（如 LoRA 放在 models/lora/，而非 models/checkpoints/）
  • 确保文件格式支持（推荐 .safetensors）
  • 再次重启 ComfyUI（有时需要重启两次才会显示）
  • 检查文件是否下载损坏（必要时重新下载）

问题 2：加载模型导致 ComfyUI 崩溃

  • 模型与 ComfyUI 版本不兼容（更新 ComfyUI）
  • 显存不足：使用更小模型（如精简版），或在 ComfyUI 设置中开启模型卸载
  • 文件损坏：从 Civitai 重新下载
  • 底模型不匹配（如将 SDXL 模型用于 SD 1.5 工作流）

问题 3：出图效果差

  • 使用 Civitai 模型页面提供的推荐提示词
  • 调整模型强度（LoRA / ControlNet）
  • 确保使用正确的 VAE（部分模型需要指定 VAE 才能达到最佳效果）
  • 检查模型版本兼容性（如 SDXL 0.9 与 SDXL 1.0）

问题 4：生成速度很慢

  • 在 ComfyUI 设置中开启模型卸载（Settings → Performance → Enable Model Offloading）
  • 降低分辨率或批次大小
  • 对大模型使用量化版本（如 4bit/8bit）
  • 升级显卡显存（长期处理大模型的解决方案）