模型教程

ComfyUI 模型路径速查

ComfyUI 模型文件路径指南,说明 Checkpoint、LoRA、VAE、ControlNet、Upscale 等文件夹用途,避免模型加载失败和下拉框空白。

有效 适用版本:2026-05 难度:新手 预计:5 分钟 更新:2026-05-12 复查:2026-06-12

一句话结论

模型放置只认类型,不认后缀。Checkpoint、LoRA、VAE、ControlNet、CLIP Vision、Upscale、Embedding 分别进不同目录,放错就会空下拉框或红节点。

这篇是模型基础链路的“地图页”:先用它判断文件应该放在哪里,再回到 Checkpoint、LoRA、VAE、ControlNet 各自页面理解它们为什么这样放。不要把路径问题、模型家族问题、节点缺失问题混成一个问题处理。

模型排错链路

你现在处在第二步:确认文件类型和目录。完整顺序是:

  1. 先确认模型家族:SD1.5、SDXL、Flux 或其他体系。
  2. 再确认文件类型和目录:Checkpoint、LoRA、VAE、ControlNet 不要混放。
  3. 如果文件不出现在节点下拉框,去 /guides/model-dropdown-empty/
  4. 如果下拉框能选但 Queue 后报错,去 /guides/model-load-failed/
  5. 模型栈正确后,再调提示词、采样器、CFG 和画质。

完整入口见:/guides/comfyui-model-troubleshooting/

先按模型系统分层理解

层级对应文件/节点先解决什么问题
基础模型Checkpoint / diffusion model / text encoder这套工作流属于 SD1.5、SDXL、Flux 还是其他家族
叠加模型LoRA、Embedding、IPAdapter是否需要角色、风格、概念或参考图特征
解码与后处理VAE、Upscale model颜色、细节、放大质量是否正常
结构控制ControlNet、CLIP Vision 等姿势、边缘、深度、参考图约束是否生效

排查顺序建议是:先确认基础模型能加载,再确认 LoRA/VAE/ControlNet 各自进了正确目录,最后才处理提示词、采样器和画质。路径错了,后面所有的调参都没有意义。

根目录先对准

先找到 ComfyUI 根目录。常见位置如下:

安装方式ComfyUI 根目录示例
Windows PortableD:\AI\ComfyUI_windows_portable\ComfyUI\
Linux git 安装/home/你的用户名/ai/ComfyUI/
WSL2/home/你的用户名/ai/ComfyUI/
云服务器/opt/ComfyUI//home/ubuntu/ComfyUI/

后面所有路径都以这个根目录为准。

所有模型都在 ComfyUI/models/ 目录下,但根据模型功能放置在完全不同的子目录中 所有模型都在 ComfyUI/models/ 目录下,但根据模型功能放置在完全不同的子目录中

常见模型路径总表

实机 ComfyUI 模型子目录映射图,Checkpoint、LoRA、VAE 必须分流

模型类型Windows 路径Linux 路径常见扩展名对应节点
CheckpointComfyUI\models\checkpoints\ComfyUI/models/checkpoints/.safetensors, .ckptLoad Checkpoint
LoRAComfyUI\models\loras\ComfyUI/models/loras/.safetensors, .ptLoad LoRA
VAEComfyUI\models\vae\ComfyUI/models/vae/.safetensors, .ptLoad VAE
ControlNetComfyUI\models\controlnet\ComfyUI/models/controlnet/.safetensors, .pthControlNet Loader
CLIP VisionComfyUI\models\clip_vision\ComfyUI/models/clip_vision/.safetensors, .binCLIP Vision Loader
IPAdapterComfyUI\models\ipadapter\ComfyUI/models/ipadapter/.safetensors, .binIPAdapter Model Loader
Upscale ModelComfyUI\models\upscale_models\ComfyUI/models/upscale_models/.pth, .ptUpscale Model Loader
EmbeddingComfyUI\models\embeddings\ComfyUI/models/embeddings/.pt, .safetensors文本提示词触发
Diffusion ModelComfyUI\models\diffusion_models\ComfyUI/models/diffusion_models/.safetensorsUNet/Diffusion Loader
Text EncoderComfyUI\models\text_encoders\ComfyUI/models/text_encoders/.safetensorsCLIP/Text Encoder Loader

注意:部分新模型工作流会使用 diffusion_modelstext_encodersvae 分离加载,不再是单个 Checkpoint。遇到 Flux、SD3、Hunyuan 等工作流时尤其要看作者说明。

具体怎么判断文件类型

1. 看下载页面标题

下载页通常会写:

  • Checkpoint / Base Model:放 checkpoints。
  • LoRA:放 loras。
  • VAE:放 vae。
  • ControlNet:放 controlnet。
  • Upscaler:放 upscale_models。
  • CLIP Vision:放 clip_vision。

不要只看扩展名。LoRA 和 Checkpoint 都可能是 .safetensors

2. 看文件大小

大致参考:

类型常见大小
SD1.5 Checkpoint2GB - 7GB
SDXL Checkpoint6GB - 13GB
LoRA10MB - 500MB
VAE100MB - 400MB
ControlNet700MB - 3GB
Upscale Model10MB - 300MB

如果你下载到一个几 KB 的 .safetensors,大概率是网页、Git LFS 指针文件或下载失败,不是真模型。

3. 看工作流节点名称

工作流里如果节点叫:

  • Load Checkpoint:需要 checkpoints。
  • Load LoRA:需要 loras。
  • Load VAE:需要 vae。
  • Load ControlNet Model:需要 controlnet。
  • CLIP Vision Loader:需要 clip_vision。

节点名称就是最直接的提示。

基于实机检查的 ComfyUI 模型目录读取标注,请确认您的文件已经如图放置

ComfyUI 真实的目录放置实机示例:以 checkpoints 文件夹为例

Back To Route

读完这篇后,回到主路线继续推进

如果这篇只解决了一个局部问题,优先按当前状态回到新手、模型、显存或工作流导入路线,避免读完后断线。