ComfyUI 模型文件夹在哪里?原生与额外路径
对于便携版或手动安装的 ComfyUI,原生模型库是 ComfyUI/models/。将每个文件放入其模型类型对应的子文件夹——检查点放在 models/checkpoints,LoRAs 放在 models/loras,VAEs 放在 models/vae。如果文件已经位于共享模型库,请把该模型库添加为额外模型路径,而不是再制作一份完整副本。
原生 ComfyUI 模型文件夹
ComfyUI 不会把 models 当作未分类的单一容器。其加载器会在已注册文件夹中查找匹配的模型类型。ComfyUI 原生 LoRA 文件夹是 ComfyUI/models/loras。放在那里的检查点仍然是检查点;改变位置不会改变文件内容。
ComfyUI/
└── models/
├── checkpoints/ # 完整扩散检查点
├── diffusion_models/ # 扩散或 UNet 权重
├── loras/ # LoRA 与相关适配器文件
├── text_encoders/ # 文本编码器权重
├── vae/ # VAE 模型
└── controlnet/ # ControlNet 和 T2I 适配器模型
当前官方配置示例还识别 unet 和 clip 等旧名称。对于新的整洁模型库,优先使用上面所示当前名称。其他节点类型可以注册更多文件夹,因此自定义节点软件包可能添加本简表中没有的模型位置。
ComfyUI Desktop:打开文件夹,不要猜测
Desktop 安装很容易被误判,因为应用管理更多布局。在 ComfyUI Desktop 中,使用 Help → Open Folder → Open Model Folder。这会打开当前活动位置,避免把模型复制到属于旧安装的同名文件夹。
当文件没有出现时,这也是最快的诊断方式。确认你查看的是正在运行应用所使用的模型文件夹,而不是文件系统搜索返回的第一个 ComfyUI 目录。
额外模型路径何时是更简洁的答案
当两个 ComfyUI 安装应看到同一模型库、另一个 UI 已拥有这些文件,或大型模型位于不同磁盘时,额外路径很有用。它告诉 ComfyUI 还应去哪里查找,但不会复制、转换、合并或备份模型。
棘手之处在于,便携版/手动安装的 ComfyUI 与 ComfyUI Desktop 使用的配置文件名不同:
- 便携版或手动安装:把
ComfyUI/extra_model_paths.yaml.example复制到ComfyUI/extra_model_paths.yaml,然后编辑副本。 - Windows 上的 Desktop:编辑
C:\Users\YourUsername\AppData\Roaming\ComfyUI\extra_models_config.yaml。 - macOS 上的 Desktop:编辑
~/Library/Application Support/ComfyUI/extra_models_config.yaml。
保留 Desktop 生成的条目。官方 Desktop 指南要求把配置添加到现有文件,而不是替换它。请先备份 YAML;缩进属于语法的一部分。
小巧、易读的额外路径配置
从一个命名明确的模型库以及实际共享的模型类型开始。base_path 是父目录;其余值都是相对于它的路径。
shared_models:
base_path: /Volumes/AI-Library/models/
checkpoints: checkpoints
loras: loras
vae: vae
controlnet: controlnet
text_encoders: text_encoders
diffusion_models: diffusion_models
在 Windows 上,为 base_path 使用绝对 Windows 路径,例如 D:\AI-Library\models\。路径中真实存在空格时予以保留;除非 YAML 解析器要求,否则不要自行添加引号或转义。最简单的配置通常最容易与磁盘上的文件夹直接比较。
重启、刷新并验证一个已知模型
保存配置并重启 ComfyUI。官方模型指南还指出 r 可刷新节点定义,但更改模型路径后,重启是更明确的检查方式。然后使用可识别文件证明设置有效:
- 从外部模型库选择一个已知检查点和一个已知 LoRA。
- 确认每个文件都出现在适当的加载器中,而不是仅仅出现在界面的某个位置。
- 加载一个现有的小型工作流程,并确认两个文件都能实际打开。
- 在全新重启后该测试成功之前,保持原位置不变。
如果模型缺失,请按顺序检查当前模型文件夹、YAML 缩进、base_path、类型专用子文件夹和文件扩展名。YAML 成功解析并不能证明检查点被归类为检查点。
额外路径不是保留方案
共享目录可避免重复工作副本,但它仍是活动运行时存储。从中删除内容可能影响指向该目录的每个 ComfyUI 安装。同样,仅因两个应用都能看到某个 SafeTensors 文件,它并不会自动获得备份。
Tensor Archive 应在运行时问题解决之后使用。识别一个已完成的相关系列——例如基础检查点及其适配器——然后单独归档、验证并还原该系列。Tensor Archive 不会重写 ComfyUI 配置或静默移除源文件夹。
根据实际问题选择下一篇指南
如果需要跨原生和额外路径保留工作流程,请使用ComfyUI 模型备份指南。如果 SSD 已被适配器填满,请按照实用指南释放 LoRA 模型库中的磁盘空间。有关训练方法和其所产生适配器工件的区别,请阅读LoRA 与 QLoRA。
来源
- ComfyUI 文档:模型 — 原生模型文件夹、Desktop 位置、额外路径配置与故障排除。
- ComfyUI: extra_model_paths.yaml.example — 当前键和便携版/手动配置结构。
- ComfyUI: folder_paths.py — 当前默认文件夹注册和旧别名。
- ComfyUI 文档:加载 LoRA — LoRA 文件的官方原生位置。