下拉框里找不到模型 / 报 Value not in list: ckpt_name not in []（模型放错目录或没刷新）

Prompt execution failed
Prompt outputs failed validation:
CheckpointLoaderSimple:
- Value not in list: ckpt_name: 'model-name.safetensors' not in []

现象与触发场景

常见触发场景：

• 从 Civitai/Reddit/教程下载的工作流，里面硬编码了作者机器上的文件名
• 把 LoRA 放进 models/checkpoints，或把 VAE 放进 models/loras
• 文件放进去了但没刷新/重启，ComfyUI 没有重新扫描目录
• extra_model_paths.yaml 写错或没生效，ComfyUI 实际搜的是别的路径

根因

• ComfyUI 只能选择它扫描到的文件，加载器节点的取值必须是该类型目录里的实际文件名。报错里单引号内的字符串是节点想要的文件，not in 后面方括号里是它真正看到的清单。
• [] 表示该类型 ComfyUI 一个文件都没扫到（目录为空或路径配置错误）；非空列表表示文件在，只是名字对不上（改名、改名后缀、子目录前缀不同）。
• 这一步属于运行前的图校验，根本没开始生成，所以和显卡、CUDA、显存都无关。

解决步骤

已按「最可能有效」排序。请从上往下做，每做完一步用「验证」确认，不要一次改五处。

1. 第一步：按模型类型放进正确子目录
   主模型 → models/checkpoints；LoRA → models/loras；VAE → models/vae；CLIP/文本编码器 → models/text_encoders（旧版为 models/clip）；CLIP Vision → models/clip_vision；ControlNet → models/controlnet；UNet/扩散模型 → models/diffusion_models（旧版为 models/unet）；放大模型 → models/upscale_models；embedding → models/embeddings。注意新版目录改名：unet 与 clip 属于旧名，新版本以 diffusion_models 与 text_encoders 为准，旧目录一般仍被兼容。
   ComfyUI/models/checkpoints/
   ComfyUI/models/loras/
   ComfyUI/models/vae/
   ComfyUI/models/text_encoders/
   ComfyUI/models/diffusion_models/
2. 第二步：刷新模型列表并重选
   在界面上按 R 刷新节点定义，或直接刷新浏览器页面；如果是运行时手工拖入文件，官方文档建议重启应用让列表更新。刷新后打开加载器下拉框重新选择该模型——工作流里存的旧名字可能和你手上的文件名只差一点点。
3. 第三步：模型在别处时配置 extra_model_paths.yaml
   便携版/手动安装的在 ComfyUI 根目录把 extra_model_paths.yaml.example 复制成 extra_model_paths.yaml（必须保留在根目录）；桌面版在胶囊菜单 → 存储（Storage）标签页添加模型目录，或编辑 C:\Users\<用户名>\AppData\Roaming\ComfyUI\extra_models_config.yaml（桌面版不要在原有配置上覆盖）。保存后必须重启 ComfyUI 才生效。同一类型可以有多个搜索路径，用 | 分行列出。
   my_custom_config:
   base_path: YOUR_PATH
   checkpoints: models/checkpoints/
   loras: models/loras/
   vae: models/vae/
   controlnet: models/controlnet/
   comfyui:
   base_path: /path/to/comfyui/
   is_default: true
   text_encoders: |
   models/text_encoders/
   models/clip/
   diffusion_models: |
   models/diffusion_models
   models/unet
   python main.py --extra-model-paths-config /path/to/config.yaml
4. 第四步：真的缺文件就去补齐
   如果方括号里列表不空、单引号里的文件确实不存在，那就是工作流要求的模型你手上没有，需要用 ComfyUI Manager 或手动下载该确切文件；别用「名字差不多」的模型顶替，架构不同会引发下一类错误。

验证是否修好

补充说明

报错文本形状有四种：not in [...]（文件在列表里但字符串不匹配，改名即可）、not in []（列表为空，属于路径/配置问题）、weight_type: 'X' not in [...]（自定义节点可选值变了，需更新节点）、Required input is missing（必填输入没连线，属另一类问题）。

来源

1. [93] （官方文档）　如何排查和解决 ComfyUI 中模型相关的问题 - ComfyUI 官方文档（缺少模型错误一节）　https://docs.comfy.org/zh/troubleshooting/model-issues
2. [97] （官方文档）　模型 - ComfyUI 官方文档（目录结构与 extra_model_paths.yaml）　https://docs.comfy.org/zh/basic-concepts/models
3. [98] （官方文档）　Model Paths Configuration - ComfyUI　https://mintlify.wiki/Comfy-Org/ComfyUI/configuration/model-paths
4. [99] （社区）　Value not in list (model not found) — ComfyUI Error Fix　https://www.numonic.ai/integrations/comfyui-errors/value-not-in-list

本条报错提到的目录

本条报错的原文或解决步骤里出现了下面这些 models/ 子目录。 权重库里放在这些目录下的文件已按目录列好，可对照确认自己缺的是哪几个。

这条报错要用到的东西

按本条报错所属的类别（模型与权重文件加载）列出站内相关的下载包与板块入口。 它们不是「必须下载才能修好」，而是这一类问题里最常要动到的东西；具体怎么做，以上面的解决步骤为准。

同一类别的其他条目

返回报错库