首页 > AI教程 >ComfyUI模型类型、目录与加载方式科普

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

来源：互联网 2026-07-22 06:18:09

ComfyUI中模型需按checkpoint、LoRA、ControlNet、VAE分类，分别放入对应目录，再选择正确加载节点并连接端口。文件、目录与节点类型一致才能生效。刷新或重启后仍不识别时，需检查架构支持、文件完整性和自定义节点依赖。额外模型路径可共享多套实例。

将一个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。

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

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

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

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

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

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端口都应连入工作流。

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

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

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

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

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

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

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

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

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

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

入口位置：模型下载页的文件说明、工作流模板提示或模型项目说明。主要动作：先确认文件类型和适用架构，再把checkpoint、LoRA、ControlNet、VAE分别放入models/checkpoints、models/loras、models/controlnet、models/vae。成功标志：文件所在子目录与准备添加的加载节点类型一致。失败处理：只知道扩展名时不要猜测；多个类型都常用safetensors，应回到模型说明或工作流缺失提示核对。
入口位置：ComfyUI画布和当前模型加载节点。主要动作：文件复制完成后先按r刷新节点定义；列表仍不更新时刷新浏览器界面或重启ComfyUI。成功标志：对应Load节点的文件下拉框出现新文件名。失败处理：重启后仍找不到时，确认正在运行的ComfyUI实例与放入文件的安装目录是同一份，避免将文件放到旧版本或另一份便携目录。
入口位置：画布空白处的节点搜索。主要动作：按模型类型添加Load Checkpoint、Load LoRA、Load ControlNet Model或Load VAE，并在下拉框选中目标文件。成功标志：节点显示具体文件名，不再是null、undefined或空列表。失败处理：文件出现但选择后报错时，先检查文件是否下载完整，再核对模型架构与当前工作流是否匹配；不是所有权重都由原生节点直接支持。
入口位置：加载节点左右两侧的彩色端口。主要动作：按数据类型将MODEL、CLIP、VAE或CONTROL_NET接到下游节点，LoRA要接在基础MODEL与CLIP链路中，ControlNet要继续进入应用节点。成功标志：端口颜色和数据类型匹配，执行时没有缺少模型输入的红色提示。失败处理：连不上或运行立即停止时，从报错节点向上游逐条检查；同名模型文件不代表输出类型相同。
入口位置：工作流顶部的Run或Queue按钮。主要动作：用最小工作流执行一次，观察模型加载阶段、采样阶段和VAE解码阶段。成功标志：节点依次运行，VAE Decode输出IMAGE，末端预览或Sa ve 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版应编辑安装时生成的现有配置文件，修改前先备份，不要覆盖或移动原文件。

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

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