ComfyUI 模型路径速查
ComfyUI 模型文件路径指南,说明 Checkpoint、LoRA、VAE、ControlNet、Upscale 等文件夹用途,避免模型加载失败和下拉框空白。
一句话结论
模型放置只认类型,不认后缀。Checkpoint、LoRA、VAE、ControlNet、CLIP Vision、Upscale、Embedding 分别进不同目录,放错就会空下拉框或红节点。
这篇是模型基础链路的“地图页”:先用它判断文件应该放在哪里,再回到 Checkpoint、LoRA、VAE、ControlNet 各自页面理解它们为什么这样放。不要把路径问题、模型家族问题、节点缺失问题混成一个问题处理。
模型排错链路
你现在处在第二步:确认文件类型和目录。完整顺序是:
- 先确认模型家族:SD1.5、SDXL、Flux 或其他体系。
- 再确认文件类型和目录:Checkpoint、LoRA、VAE、ControlNet 不要混放。
- 如果文件不出现在节点下拉框,去
/guides/model-dropdown-empty/。 - 如果下拉框能选但 Queue 后报错,去
/guides/model-load-failed/。 - 模型栈正确后,再调提示词、采样器、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 Portable | D:\AI\ComfyUI_windows_portable\ComfyUI\ |
| Linux git 安装 | /home/你的用户名/ai/ComfyUI/ |
| WSL2 | /home/你的用户名/ai/ComfyUI/ |
| 云服务器 | /opt/ComfyUI/ 或 /home/ubuntu/ComfyUI/ |
后面所有路径都以这个根目录为准。
常见模型路径总表

| 模型类型 | Windows 路径 | Linux 路径 | 常见扩展名 | 对应节点 |
|---|---|---|---|---|
| Checkpoint | ComfyUI\models\checkpoints\ | ComfyUI/models/checkpoints/ | .safetensors, .ckpt | Load Checkpoint |
| LoRA | ComfyUI\models\loras\ | ComfyUI/models/loras/ | .safetensors, .pt | Load LoRA |
| VAE | ComfyUI\models\vae\ | ComfyUI/models/vae/ | .safetensors, .pt | Load VAE |
| ControlNet | ComfyUI\models\controlnet\ | ComfyUI/models/controlnet/ | .safetensors, .pth | ControlNet Loader |
| CLIP Vision | ComfyUI\models\clip_vision\ | ComfyUI/models/clip_vision/ | .safetensors, .bin | CLIP Vision Loader |
| IPAdapter | ComfyUI\models\ipadapter\ | ComfyUI/models/ipadapter/ | .safetensors, .bin | IPAdapter Model Loader |
| Upscale Model | ComfyUI\models\upscale_models\ | ComfyUI/models/upscale_models/ | .pth, .pt | Upscale Model Loader |
| Embedding | ComfyUI\models\embeddings\ | ComfyUI/models/embeddings/ | .pt, .safetensors | 文本提示词触发 |
| Diffusion Model | ComfyUI\models\diffusion_models\ | ComfyUI/models/diffusion_models/ | .safetensors | UNet/Diffusion Loader |
| Text Encoder | ComfyUI\models\text_encoders\ | ComfyUI/models/text_encoders/ | .safetensors | CLIP/Text Encoder Loader |
注意:部分新模型工作流会使用 diffusion_models、text_encoders、vae 分离加载,不再是单个 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 Checkpoint | 2GB - 7GB |
| SDXL Checkpoint | 6GB - 13GB |
| LoRA | 10MB - 500MB |
| VAE | 100MB - 400MB |
| ControlNet | 700MB - 3GB |
| Upscale Model | 10MB - 300MB |
如果你下载到一个几 KB 的 .safetensors,大概率是网页、Git LFS 指针文件或下载失败,不是真模型。
3. 看工作流节点名称
工作流里如果节点叫:
Load Checkpoint:需要 checkpoints。Load LoRA:需要 loras。Load VAE:需要 vae。Load ControlNet Model:需要 controlnet。CLIP Vision Loader:需要 clip_vision。
节点名称就是最直接的提示。


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