ComfyUI 模型类型 目录与加载方式科普

把一个 safetensors 文件放进 ComfyUI 后，节点下拉框里却找不到它，通常不是“模型坏了”，而是类型、目录或加载节点没有对应上。最实用的判断方法是先分清它属于 checkpoint、LoRA、ControlNet 还是独立 VAE，再核对存放目录和节点输出。文件名、文件夹名和 Load 节点三者一致，模型才真正进入工作流。

适用范围是已经能启动 ComfyUI，需要在 Windows、macOS 或 Linux 上整理本地模型并完成首次加载的读者。这里讨论 ComfyUI 原生常见模型；依赖社区自定义节点的 GGUF、量化权重或新架构可能采用不同目录和加载器，应以对应项目的当前说明为准。

先把“模型”分成基础权重和辅助权重

ComfyUI 里的模型是工作流实际调用的权重文件，应用本体默认不会附带这些大文件。Checkpoint 通常承担基础生成能力；LoRA、ControlNet、独立 VAE 和放大模型则在特定位置补充风格、结构控制、图像编解码或分辨率处理。它们不是把文件都塞进同一个目录后自动生效，而是分别由对应节点读取。

下图是 ComfyUI 官方文档展示的辅助模型工作流。左上角 checkpoint 提供基础 MODEL、CLIP 和 VAE，左下角 ControlNet 通过独立节点加载，再进入 Apply ControlNet。观察连线就能看出：辅助模型要接到基础链路上，不能替代基础 checkpoint。

Checkpoint：先建立能运行的基础模型链路

Checkpoint 是最常见的起点，默认放在 ComfyUI/models/checkpoints。官方的 Load Checkpoint 节点会从该目录和额外模型路径中读取文件，并拆出三类输出：MODEL 用于潜空间去噪，CLIP 把提示词编码为条件，VAE 负责潜空间与像素图像之间的转换。

下图中 ckpt_name 已显示实际文件，右侧同时出现 MODEL、CLIP、VAE。这张图只证明 checkpoint 的加载结果和三个输出，不代表该文件一定兼容任意工作流。

LoRA：在基础 MODEL 和 CLIP 上叠加变化

LoRA 是体积较小的适配权重，常用于风格、角色或特定概念，默认目录为 ComfyUI/models/loras。Load LoRA 不能悬空使用：左侧的 model 与 clip 要接收基础模型输出，右侧再输出应用 LoRA 后的 MODEL 与 CLIP。strength_model 和 strength_clip 分别控制它对模型权重与文本编码的影响。

下图的 lora_name 仍显示 undefined，正好说明成功标志是什么：真实使用时这里必须变成 models/loras 中的文件名，并且左右两组 MODEL、CLIP 端口都应连入工作流。

ControlNet：用边缘、深度或姿态约束构图

ControlNet 提供额外条件控制，常见输入包括边缘图、深度图、姿态关键点和涂鸦图，默认放在 ComfyUI/models/controlnet。Load ControlNet Model 只负责读入权重并输出 CONTROL_NET；后面还要连接 Apply ControlNet，并提供参考图以及正、负条件。只有加载节点而没有应用节点，约束不会进入采样过程。

官方节点图中，control_net_name 显示具体权重，右侧只有 CONTROL_NET 输出。它与 checkpoint 的三输出结构不同，选节点时不要只看文件扩展名。

VAE：负责潜空间和像素图像之间的转换

不少 checkpoint 已经包含可用 VAE，Load Checkpoint 会直接输出它；模型作者要求单独 VAE 时，再把文件放进 ComfyUI/models/vae 并使用 Load VAE。VAE Decode 接收采样器产生的 samples 和 VAE，输出能预览、保存的 IMAGE。因此“加载 VAE”和“用 VAE 解码”是两个动作，前者选权重，后者完成转换。

下图只展示解码环节：红色 vae 与粉色 samples 都要有连接，右侧蓝色 IMAGE 才能继续进入 Save Image。

按五步让模型文件真正出现在节点里

1. 入口位置：模型下载页的文件说明、工作流模板提示或模型项目说明。主要动作：先确认文件类型和适用架构，再把 checkpoint、LoRA、ControlNet、VAE 分别放进 models/checkpoints、models/loras、models/controlnet、models/vae。成功标志：文件所在子目录与准备添加的加载节点类型一致。失败处理：只知道扩展名时不要猜；多个类型都常用 safetensors，应回到模型说明或工作流缺失提示核对。

2. 入口位置：ComfyUI 画布和当前模型加载节点。主要动作：文件复制完成后先按 r 刷新节点定义；列表仍不更新时刷新浏览器界面或重启 ComfyUI。成功标志：对应 Load 节点的文件下拉框出现新文件名。失败处理：重启后仍找不到时，确认正在运行的 ComfyUI 实例与放入文件的安装目录是同一份，避免把文件放到旧版本或另一份便携目录。

3. 入口位置：画布空白处的节点搜索。主要动作：按模型类型添加 Load Checkpoint、Load LoRA、Load ControlNet Model 或 Load VAE，并在下拉框选中目标文件。成功标志：节点显示具体文件名，不再是 null、undefined 或空列表。失败处理：文件出现但选择后报错时，先检查文件是否下载完整，再核对模型架构与当前工作流是否匹配；不是所有权重都由原生节点直接支持。

4. 入口位置：加载节点左右两侧的彩色端口。主要动作：按数据类型把 MODEL、CLIP、VAE 或 CONTROL_NET 接到下游节点，LoRA 要接在基础 MODEL 与 CLIP 链路中，ControlNet 要继续进入应用节点。成功标志：端口颜色和数据类型匹配，执行时没有缺少模型输入的红色提示。失败处理：连不上或运行立即停止时，从报错节点向上游逐条检查；同名模型文件不代表输出类型相同。

5. 入口位置：工作流顶部的 Run 或 Queue 按钮。主要动作：用最小工作流执行一次，观察模型加载阶段、采样阶段和 VAE 解码阶段。成功标志：节点依次运行，VAE Decode 输出 IMAGE，末端预览或 Save Image 出现结果。失败处理：文件能选择但加载失败时，记录首个报错节点与错误文本，再排查架构、显存、缺少自定义节点或权重损坏，不要反复移动文件夹掩盖真正原因。

多套 ComfyUI 共用模型时配置额外路径

模型占用空间较大，多份 ComfyUI 重复保存同一批权重并不划算。便携版或手动安装版可在 ComfyUI 根目录复制 extra_model_paths.yaml.example 并改名为 extra_model_paths.yaml，用 base_path 配合 checkpoints、loras、vae、controlnet 等键声明共享目录。保存后要重启 ComfyUI。

ComfyUI Desktop 已提供菜单入口。下图从左上角菜单进入 Help，展开 Open Folder，再选择 Open extra_model_paths.yaml。Desktop 版应编辑安装时生成的现有配置文件，修改前先备份，不要覆盖或移动原文件。

1. 入口位置：Desktop 的 Help 菜单，或便携版、手动安装版的 ComfyUI 根目录。主要动作：打开额外模型路径配置，备份原文件后填写共享模型根目录和各类型子目录。成功标志：保存并重启后，对应 Load 节点能列出共享目录中的模型，原有默认目录仍可使用。失败处理：全部模型同时消失时立即恢复备份，重点检查缩进、路径拼写和 base_path；只缺一类模型时检查该类型键名与子目录。

用六个结果确认分类与加载没有错位

• 四类常用文件已分别进入 checkpoints、loras、controlnet、vae 目录，或被额外路径明确映射。
• Checkpoint 节点显示文件名，并输出 MODEL、CLIP、VAE。
• LoRA 节点接收基础 MODEL 与 CLIP，文件名和两项强度都有有效值。
• ControlNet 节点输出 CONTROL_NET，后面还有应用节点和参考图条件。
• 独立 VAE 只在确有需要时加载，VAE Decode 同时接收 samples 与 vae。
• 刷新或重启后仍无法识别的文件，已转向检查架构支持、文件完整性和自定义节点依赖，而不是继续猜目录。

整理模型时，把“类型、目录、加载节点、输出端口”记成一组，比背文件名更可靠。新模型支持会随 ComfyUI 和社区节点变化，遇到模板提示缺少模型时，先确认它要求的是哪种加载器，再决定放置位置；这样既能少复制大文件，也能把大部分“模型不见了”的问题定位到具体一层。