📦 快速资料包
只想赶快装好?这里就够了。
- 打开 ComfyUI 文件夹里的 models 文件夹。
- 照下面的对照表,把文件放进对应的子文件夹。
- 回到 ComfyUI 按键盘 R(或刷新网页),在节点的下拉菜单选你的文件。
想知道原理、实测数据和常见问题?往下看完整教程 ↓
要点速览
ComfyUI 的模型都放在 ComfyUI/models/ 底下,按种类分文件夹:完整模型放 checkpoints、单独的扩散模型(Flux、Wan、Qwen-Image 这类)放 diffusion_models、文字编码器放 text_encoders、VAE 放 vae、LoRA 放 loras。判断方法很简单:Comfy-Org 官方整理的下载页,路径里的 split_files/ 后面那一层就是文件夹名称。放好之后按键盘 R 或刷新网页,节点的下拉菜单就会出现。找不到时,先确认文件夹名称有没有拼错、文件有没有下载完整。
下载了好几 GB 的模型,打开 ComfyUI 却在下拉菜单里找不到?这几乎都是同一个原因:放错文件夹。
ComfyUI 不会自己去找模型,它只看 models 底下固定名称的文件夹。每一种模型有自己的位置,放错一层,节点就看不到。
一张表:每种模型放哪里
所有路径都在 ComfyUI/models/ 底下。
| 模型种类 | 放这里 | 常见例子 | 用哪个节点加载 |
|---|---|---|---|
| 完整模型(模型+编码器+VAE 包在一起) | checkpoints | SDXL、SD 1.5 的大部分模型 | Load Checkpoint |
| 单独的扩散模型 | diffusion_models(旧名 unet) | Flux、Wan 2.2、Qwen-Image、MiniMax H3 | Load Diffusion Model |
| GGUF 量化模型 | unet 或 diffusion_models | 文件名结尾是 .gguf | Unet Loader (GGUF) |
| 文字编码器 | text_encoders(旧名 clip) | T5、UMT5、Qwen2.5-VL、CLIP-L | Load CLIP/DualCLIPLoader |
| VAE | vae | ae.safetensors、wan_2.1_vae | Load VAE |
| LoRA | loras | 风格、角色、加速 LoRA | LoRA Loader |
| 图像编码器 | clip_vision | 给「参考图」功能用的 | Load CLIP Vision |
| ControlNet | controlnet | 线稿、深度、姿势控制 | Load ControlNet Model |
| 放大模型 | upscale_models | 4x-UltraSharp、RealESRGAN | Load Upscale Model |
| Embedding | embeddings | 负面提示词的 embedding | 写在提示词里 |
自订节点的模型不一定在上面的文件夹里。例如 ComfyUI-ClipProj 的投影头放在 clip_projections。遇到这种情况,以那个节点的说明为准。
怎么判断你下载的是哪一种?
方法一:看下载页的路径(最准)
Comfy-Org 在 Hugging Face 整理的模型,文件路径都长这样:
split_files/diffusion_models/wan2.2_i2v_high_noise_14B_fp8_scaled.safetensorssplit_files/text_encoders/umt5_xxl_fp8_e4m3fn_scaled.safetensorssplit_files/vae/wan_2.1_vae.safetensors
split_files/ 后面那一层,就是要放的文件夹名称。 照抄就不会错。
方法二:看文件名
| 文件名里有 | 通常是 |
|---|---|
vae、ae | VAE |
t5、umt5、clip、qwen_2.5_vl、text_encoder | 文字编码器 |
lora | LoRA |
.gguf 结尾 | GGUF 量化模型 |
controlnet、canny、depth | ControlNet |
4x、esrgan、upscale | 放大模型 |
方法三:看工作流的说明
好的工作流(包括我们实验室里的)会附上下载清单,写清楚每个文件放哪里。我们自己的工作流,左上角都有一张「下载清单」说明卡。
放好之后,ComfyUI 怎么读到?
- 回到 ComfyUI 的网页,按键盘的 R,或直接刷新网页;
- 点开加载模型的节点,在下拉菜单里选你的文件;
- 如果打开别人的工作流,节点上的文件名和你的不一样,从下拉菜单选你自己下载的那个就好,不用改文件名。
找不到模型?照这个顺序检查
- 文件夹名称拼错:最常见的是少了
s,例如lora应该是loras、checkpoint应该是checkpoints; - 多包了一层文件夹:解压缩后变成
loras/某某文件夹/文件.safetensors。大部分情况下其实读得到,但会显示成「某某文件夹/文件」,在下拉菜单里要往下找; - 文件没下载完整:比对一下文件大小和下载页上写的是否一样,没下完的文件加载时会出错;
- 放到别的 ComfyUI 里了:电脑里如果装了两份 ComfyUI(例如可携版和桌面版),确认你放的是正在用的那一份;
- 没有刷新:按 R 或刷新网页。
模型太多,硬盘不够?
模型动辄十几 GB,C 槽很快就满了。ComfyUI 可以从别的硬盘读模型:
- 在 ComfyUI 文件夹里找到
extra_model_paths.yaml.example; - 拷贝一份,改名成
extra_model_paths.yaml; - 用记事本打开,把里面的路径改成你另一颗硬盘的模型文件夹;
- 重新启动 ComfyUI。
这样模型可以统一放在 D 槽或外置硬盘,以后重装 ComfyUI 也不用重新下载。
想知道你的显卡跑得动哪些模型,可以看实验 #001:你的显卡能跑多大的模型?
常见问题
为什么有的教学说放 unet、有的说放 diffusion_models?
diffusion_models 是新的名称,unet 是旧名称。现在的 ComfyUI 两个文件夹都会读,放哪一个都可以。GGUF 格式的模型要看 ComfyUI-GGUF 节点,旧版只读 unet,新版两个都读,以节点下拉菜单看得到为准。
text_encoders 和 clip 是同一个文件夹吗?
是同一类。text_encoders 是新名称,clip 是旧名称,ComfyUI 两个都会读。
文件放进去了,下拉菜单还是找不到?
依序检查:文件夹名称有没有拼错(例如少了 s)、文件是不是多包了一层文件夹、文件有没有下载完整(大小是否和下载页一样)、有没有按 R 或刷新网页。如果是自订节点专用的模型,请看那个节点的说明,它可能有自己的文件夹。
模型太大,可以放在别的硬盘吗?
可以。把 ComfyUI 文件夹里的 extra_model_paths.yaml.example 拷贝一份、改名成 extra_model_paths.yaml,在里面填上另一个硬盘的路径,ComfyUI 就会一起读那里的模型。
留言
用 GitHub 账号登录就能留言,留言会公开显示在 GitHub Discussions。留言前请先看社区规则。