用ComfyUI最头疼的不是界面，不是节点，是模型。
你从Civitai下了个模型，放到文件夹里，打开ComfyUI一加载——报错。换个文件夹试试——还是报错。再下另一个模型——有时候能加载，有时候不能。搞了半天，不知道问题出在哪。
这篇文章不教你"第一步放这里、第二步点那里"，因为每个人用的版本不同、系统不同、安装方式不同，照着做反而容易出错。我要把为什么说清楚，你知道了为什么，自己就能排查。
---
这是很多人搞混的第一个地方。"模型"这个词在ComfyUI里至少指四种不同的东西：
Checkpoint（大模型/底模型）：这是完整的生成模型，通常2GB到7GB不等。它包含了文本理解、图像生成、解码三个部分。你每次出图，至少需要加载一个Checkpoint。常见的有SD 1.5、SDXL、SD3等。它们之间的差别不是"新版更好"那么简单——不同版本的Checkpoint需要不同版本的ComfyUI和不同格式的VAE来配合，混用就会出问题。
LoRA（风格微调模型）：通常几十MB到几百MB。它不能单独使用，必须配合Checkpoint。你可以理解为"在底模型上叠加一层风格"，比如水墨画风格、胶片质感、某个人物的特征。LoRA和Checkpoint之间有兼容性问题——用SDXL的Checkpoint，就得配SDXL的LoRA，用SD 1.5的LoRA会报错或者出废图。
VAE（解码器）：负责把模型内部的隐空间表示转成你能看到的图像。有的Checkpoint自带VAE（比如SDXL），有的不带（比如某些SD 1.5的微调版）。如果你用的Checkpoint没有自带VAE，加载后会出现全黑或全紫的图片，这不是模型坏了，是缺了VAE。
ControlNet（控制模型）：用来控制生成图像的构图、姿态、边缘等。每个ControlNet模型对应一种控制方式（线稿、深度图、姿态检测等），而且也要跟Checkpoint版本匹配——SD 1.5的ControlNet不能用在SDXL上。
这四种东西，每一种放错位置、用错版本，都会报错。下面一个一个说。
---
ComfyUI的模型文件夹结构是这样的：
``
ComfyUI/
├── models/
│ ├── checkpoints/ ← Checkpoint放这里
│ ├── lora/ ← LoRA放这里
│ ├── vae/ ← VAE放这里
│ ├── controlnet/ ← ControlNet放这里
│ ├── clip/ ← CLIP模型（一般不需要手动放）
│ └── unet/ ← 部分新格式模型
├── output/ ← 生成的图片
└── ...
`
每个文件夹对应一种模型类型，放错了ComfyUI就找不到。 这听起来很基础，但实际操作中经常出错，原因有几个：
1. 下载的压缩包里有多个文件。 比如一个Civitai上的模型包，可能同时包含Checkpoint、LoRA和VAE。你需要把每个文件分别放到对应的文件夹，而不是整个包扔进一个目录。
2. 文件格式不一样。 Checkpoint通常是.safetensors或.ckpt格式。LoRA也是.safetensors，但它们不能混放——光看扩展名分不出来，得看文件大小和来源。LoRA一般不超过1GB，Checkpoint通常2GB以上。如果不确定，先看下载页面的说明。
3. 有些模型需要额外的配置文件。 比如部分ControlNet模型除了主文件外，还需要一个同名的.yaml配置文件。少了这个文件，加载时会报"missing config"之类的错误。
4. 路径里有中文或特殊字符。 如果你的ComfyUI装在"D:\我的软件\ComfyUI\"这种路径下，模型加载可能会失败。这不是ComfyUI本身的bug，是底层依赖库的问题。把路径改成全英文，能省掉大量莫名其妙的报错。
---
这是新手最常遇到的问题，也是最容易被误判的。
最常见的原因：缺VAE。
SD 1.5时代，很多微调版Checkpoint把VAE单独剥离出来了，加载时需要手动指定VAE。如果你只加载了Checkpoint没加载VAE，出来的图就是全黑或全紫色的。
解决方法：在ComfyUI的工作流里加一个"Load VAE"节点，选择一个VAE文件（通常用vae-ft-mse-840000-ema-pruned.safetensors`，这是SD 1.5最常用的VAE），然后把它连到Checkpoint Loader的vae输出上。
SDXL的Checkpoint一般自带VAE，不需要额外加载。但有些SDXL微调版也会剥离VAE，出图变黑时同样需要手动加载。
第二个常见原因：LoRA和Checkpoint版本不匹配。
你用了SDXL的Checkpoint，但加载了SD 1.5的LoRA。这种情况下ComfyUI不会直接报错，但生成的图要么是噪点，要么严重变形，要么根本看不出内容。这个错误最隐蔽，因为不报错，只是效果不对。
排查方法：确认你的Checkpoint是哪个版本的（SD 1.5、SDXL、SD3），然后确认LoRA也是同一个版本的。Civitai上每个模型页面都会标注基础模型版本，下载前看一眼。
---
Civitai（civitai.com）：最主流的模型分享平台，模型种类最全。坑在于——模型质量参差不齐，很多模型只有作者自己能跑出展示图的效果。下载前一定要看评论区，看看其他用户反馈的实际效果。另外，Civitai上的模型有版权限制，部分模型禁止商用，用于公众号配图前要确认授权。
Hugging Face（huggingface.co）：偏技术向，模型更规范，文档更全。ControlNet、CLIP等基础模型主要在这里下载。坑在于界面不如Civitai直观，文件结构复杂，有时候需要手动翻找正确的文件。
国内镜像站：有些Hugging Face的镜像在国内访问更快。但要注意，镜像站的模型可能不是最新版本，下载前对比一下更新时间。用过期模型可能导致兼容性问题。
下载速度也是个实际问题。一个7GB的Checkpoint，国内网络直接下可能要好几个小时甚至中断。用多线程下载工具（如IDM、aria2）会好很多，但有些平台不允许使用下载工具，要注意平台规则。
---
有时候所有东西都放对了位置，版本也对，但就是加载失败。这时候要考虑一个可能：文件在下载过程中损坏了。
大文件下载中断后自动续传，有时候文件大小看起来对，但内容已经不完整。表现是：加载时报"invalid model file"、"corrupted data"或者直接闪退。
确认方法：对比文件大小。 下载页面上通常标注了文件大小，如果本地文件比标注的小，就是没下完。但如果大小一样还是报错，可能是下载过程中的数据损坏，需要重新下载。
还有一个容易忽略的情况：磁盘空间不足导致文件写入不完整。 模型文件动辄几GB，如果你的磁盘只剩几百MB空间，文件会写入失败但不会给你明显的提示。下载前先检查磁盘剩余空间，至少预留文件大小两倍的空间（因为下载过程中会先写临时文件再重命名）。
---
1. 每次只改一个变量。 加了新模型后出问题了，先去掉新模型看是否恢复正常。不要同时改多个设置，否则找不到问题源头。
2. 看ComfyUI的控制台输出。 界面上的报错信息往往不完整，控制台（命令行窗口）里会显示更详细的错误原因，包括具体的文件路径和报错行号。
3. 保留一份能正常工作的配置。 找到一组能正常出图的Checkpoint+LoRA+VAE组合后，把工作流保存下来。以后遇到问题，先用这个基准配置测试，确认是模型问题还是环境问题。
4. 不要囤模型。 有些人下载了几十上百个模型，大部分从来不用，占了几百GB空间，找模型的时候还要翻半天。先用好一两个基础模型，有明确需求再下载新的。
评论区