ComfyUI 安装后模型下拉框为空怎么办
解决 ComfyUI model not showing in dropdown、Checkpoint 不显示、LoRA 下拉框为空等问题，用 30 秒清单检查模型类型、目录、文件后缀、刷新重启、运行实例和 extra_model_paths。
一句话结论
Load Checkpoint 下拉框为空，优先检查三件事：文件是不是 Checkpoint、目录是不是 ComfyUI/models/checkpoints/、放完模型后有没有刷新或重启 ComfyUI。
模型排错链路
你现在处在第三步：模型发现问题。完整顺序是：
- 先确认模型家族：SD1.5、SDXL、Flux 或其他体系。
- 再确认文件类型和目录：Checkpoint、LoRA、VAE、ControlNet 不要混放。
- 如果文件不出现在节点下拉框，留在本页检查目录、刷新、运行实例和 extra paths。
- 如果下拉框能选但 Queue 后报错，去
/guides/model-load-failed/。 - 模型栈正确后，再调提示词、采样器、CFG 和画质。
完整入口见：/guides/comfyui-model-troubleshooting/。
这张检查图用于确认文件类型、目录层级和重启顺序；最终仍以 ComfyUI 下拉框或 API 能否列出模型为准。
上图左侧是本机 ComfyUI 页面，右侧是从 ComfyUI API 读到的 checkpoints 列表。真实排查时不要只刷新网页，要确认模型文件确实能被 ComfyUI 读到。
它在排错链路里的位置
模型下拉框为空，说明 ComfyUI 还没有把某个文件识别成这个节点需要的模型。它通常发生在“模型家族选择”之后、“模型加载失败”之前：你已经决定要 SD1.5、SDXL 或 Flux，但文件还没有出现在对应节点里。
排查顺序不要反过来：先确认模型家族，再确认文件类型和目录，最后才看加载报错。如果下拉框本来就是空的，shape mismatch、显存不足、采样器设置都还不是第一问题。
| 现象 | 应该去哪里排查 |
|---|---|
| 不知道该下载 SD1.5 还是 SDXL | 先看 /guides/sd15-vs-sdxl/ |
| 文件在电脑里，但节点下拉框为空 | 留在本页查类型、目录、刷新和运行实例 |
| 下拉框能选模型，但 Queue 后报错 | 去 /guides/model-load-failed/ 查文件损坏、体系不匹配、显存 |
| 红色节点或节点类型不存在 | 去缺失节点/工作流导入排查，不要把它当模型文件问题 |
30 秒检查清单
先不要重装，也不要继续下载更多模型。按下面顺序快速判断：
| 检查项 | 怎么判断 | 如果不对怎么办 |
|---|---|---|
| 文件类型 | Checkpoint 才会出现在 Load Checkpoint；LoRA、VAE、ControlNet 有各自节点 | 回到模型下载页确认 Base Model 和文件类型 |
| 目标目录 | Checkpoint 在 models/checkpoints/，LoRA 在 models/loras/，VAE 在 models/vae/ | 按 /guides/model-file-paths/ 重新放置 |
| 文件完整 | 文件大小通常不是几 KB，后缀不是 .tmp、.download、.html、.txt | 删除可疑文件，重新下载模型本体 |
| 刷新方式 | 只刷新浏览器不一定重载后端模型列表 | 点模型刷新按钮，或关闭启动窗口后重启 ComfyUI |
| 运行实例 | 你放文件的目录和当前网页对应的是同一套 ComfyUI | 关闭多余实例，只保留一套正在运行的 ComfyUI |
| 外部路径 | 使用 extra_model_paths.yaml 时，路径拼写和缩进必须正确 | 暂时把模型放回默认 models/ 目录验证 |
如果你能在文件管理器里看到模型，但 ComfyUI 里还是空，十有八九是目录、文件类型、运行实例或刷新方式对不上。下拉框为空时不要先查 shape mismatch 或 CUDA out of memory，那些属于模型已经被发现之后的问题。
按英文搜索词对照症状
| 你搜索的问题 | 本质原因 | 本页先做什么 |
|---|---|---|
ComfyUI model not showing in dropdown | 模型没有被对应节点发现 | 查文件类型、目录、刷新、运行实例 |
ComfyUI checkpoint not showing | Checkpoint 不在 models/checkpoints/ 或文件不是 checkpoint | 用 Load Checkpoint 对照 checkpoints 目录 |
ComfyUI LoRA not showing | LoRA 不在 models/loras/，或你在 Checkpoint Loader 里找 LoRA | 换 LoRA Loader，并检查 loras 目录 |
ComfyUI VAE dropdown empty | VAE 文件目录或节点不对 | 检查 models/vae/ 和 VAE Loader |
ComfyUI refresh models not working | 后端没有重载、实例不对或外部路径没生效 | 重启 ComfyUI 后端，确认启动日志读取的是同一目录 |
先判断你缺的是哪种模型
很多新手把所有 .safetensors 都当成“模型”，但 ComfyUI 会按类型分目录读取：
- Checkpoint：主模型，出现在 Load Checkpoint 下拉框。
- LoRA：风格或角色补丁，不会出现在 Load Checkpoint 里。
- VAE：色彩/解码文件，也不会出现在 Load Checkpoint 里。
- ControlNet：控制线稿、姿势、深度图的模型，不在 Checkpoint 下拉框。
如果你下载的是 LoRA，却一直找 Load Checkpoint，下拉框当然还是空。
还是空时按这个顺序查
- 看文件名：后缀不能是
.tmp、.download、.crdownload、.html，也不能被系统藏成.safetensors.txt。 - 看文件大小：几 KB 或几十 KB 的文件通常不是模型本体，可能是下载页、错误页或未完成临时文件。
- 看模型类型：Civitai/Hugging Face 页面上的
Checkpoint、LoRA、VAE、ControlNet会决定它进入哪个目录。 - 看运行目录：启动窗口里显示的 ComfyUI 根目录，必须和你放文件的目录一致。
- 看刷新方式：先点模型刷新按钮；没有刷新按钮或仍然为空时，关闭启动窗口并重新启动。
- 看外部路径：如果你改过
extra_model_paths.yaml，先把一个测试 checkpoint 放回默认目录验证，不要同时排查 YAML 和模型文件。
如果控制台已经出现 failed to load、permission denied、No such file，说明它可能已经从“下拉框为空”进入“加载失败”或权限问题，下一步要按报错关键词处理。
很多人会误判的情况
- 以为所有
.safetensors都能进 Checkpoint。 - 以为“下载完成”就已经放到了正确目录，其实还留在浏览器下载目录。
- 以为网页刷新等于 ComfyUI 重载，实际上后端没重启的话还是旧缓存。
- 看到 SDXL 工作流缺模型，却下载了 SD1.5 LoRA 或 ControlNet。
- 同时打开两份 ComfyUI，把模型放进 A 目录，却在 B 页面里找。
正确放置目录
Windows portable 常见路径是：
ComfyUI_windows_portable/ComfyUI/models/checkpoints/
Linux 或源码安装常见路径是：
ComfyUI/models/checkpoints/
注意是 checkpoints 复数，不是 checkpoint。也不要放到 models/loras/、models/vae/ 或 input/。
操作步骤
- 下载一个真正的 Checkpoint，例如 SD1.5 或 SDXL checkpoint。
- 确认文件后缀通常是
.safetensors或.ckpt。 - 把文件放进
ComfyUI/models/checkpoints/。 - 回到 ComfyUI 页面，点击模型下拉框旁边的刷新按钮。
- 如果仍然不显示，彻底关闭启动窗口，再重新启动 ComfyUI。
- 还不显示，就看启动窗口有没有
failed to load、permission、No such file之类报错。
常见错误
- 把 LoRA 当成 Checkpoint。
- 下载了网页预览图，不是模型文件。
- 文件还在浏览器下载临时目录，没有移动到 ComfyUI。
- 模型文件名带
.download、.tmp，说明没下载完。 - 解压错层级，实际路径变成
checkpoints/checkpoints/xxx.safetensors。
验证是否成功
下拉框里能看到模型文件名，并且最小工作流点击 Queue 后能进入生成队列。如果能选模型但生成时报错，再去看 /guides/model-load-failed/。
如果你最后仍然看不到模型，回到 /guides/model-file-paths/ 对照一次目录表，通常能很快定位是不是放错类型了。
下一步推荐
- 完整模型目录表：
/guides/model-file-paths/ - 第一次出图：
/guides/first-image-generation/ - Civitai 下载模型：
/guides/civitai-model-download/