ComfyUI 模型文件夹在哪里?原生与额外路径

对于便携版或手动安装的 ComfyUI,原生模型库是 ComfyUI/models/。将每个文件放入其模型类型对应的子文件夹——检查点放在 models/checkpoints,LoRAs 放在 models/loras,VAEs 放在 models/vae。如果文件已经位于共享模型库,请把该模型库添加为额外模型路径,而不是再制作一份完整副本。

原生 ComfyUI 模型文件夹与外部共享张量库汇入同一个运行时加载器。
ComfyUI 可以在其原生目录和你明确声明的附加模型库中发现模型类型。

原生 ComfyUI 模型文件夹

ComfyUI 不会把 models 当作未分类的单一容器。其加载器会在已注册文件夹中查找匹配的模型类型。ComfyUI 原生 LoRA 文件夹是 ComfyUI/models/loras。放在那里的检查点仍然是检查点;改变位置不会改变文件内容。

ComfyUI/
└── models/
    ├── checkpoints/       # 完整扩散检查点
    ├── diffusion_models/  # 扩散或 UNet 权重
    ├── loras/             # LoRA 与相关适配器文件
    ├── text_encoders/     # 文本编码器权重
    ├── vae/               # VAE 模型
    └── controlnet/        # ControlNet 和 T2I 适配器模型

当前官方配置示例还识别 unetclip 等旧名称。对于新的整洁模型库,优先使用上面所示当前名称。其他节点类型可以注册更多文件夹,因此自定义节点软件包可能添加本简表中没有的模型位置。

ComfyUI Desktop:打开文件夹,不要猜测

Desktop 安装很容易被误判,因为应用管理更多布局。在 ComfyUI Desktop 中,使用 Help → Open Folder → Open Model Folder。这会打开当前活动位置,避免把模型复制到属于旧安装的同名文件夹。

当文件没有出现时,这也是最快的诊断方式。确认你查看的是正在运行应用所使用的模型文件夹,而不是文件系统搜索返回的第一个 ComfyUI 目录。

额外模型路径何时是更简洁的答案

当两个 ComfyUI 安装应看到同一模型库、另一个 UI 已拥有这些文件,或大型模型位于不同磁盘时,额外路径很有用。它告诉 ComfyUI 还应去哪里查找,但不会复制、转换、合并或备份模型。

棘手之处在于,便携版/手动安装的 ComfyUI 与 ComfyUI Desktop 使用的配置文件名不同:

保留 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 可刷新节点定义,但更改模型路径后,重启是更明确的检查方式。然后使用可识别文件证明设置有效:

  1. 从外部模型库选择一个已知检查点和一个已知 LoRA。
  2. 确认每个文件都出现在适当的加载器中,而不是仅仅出现在界面的某个位置。
  3. 加载一个现有的小型工作流程,并确认两个文件都能实际打开。
  4. 在全新重启后该测试成功之前,保持原位置不变。

如果模型缺失,请按顺序检查当前模型文件夹、YAML 缩进、base_path、类型专用子文件夹和文件扩展名。YAML 成功解析并不能证明检查点被归类为检查点。

额外路径不是保留方案

共享目录可避免重复工作副本,但它仍是活动运行时存储。从中删除内容可能影响指向该目录的每个 ComfyUI 安装。同样,仅因两个应用都能看到某个 SafeTensors 文件,它并不会自动获得备份。

Tensor Archive 应在运行时问题解决之后使用。识别一个已完成的相关系列——例如基础检查点及其适配器——然后单独归档、验证并还原该系列。Tensor Archive 不会重写 ComfyUI 配置或静默移除源文件夹。

根据实际问题选择下一篇指南

如果需要跨原生和额外路径保留工作流程,请使用ComfyUI 模型备份指南。如果 SSD 已被适配器填满,请按照实用指南释放 LoRA 模型库中的磁盘空间。有关训练方法和其所产生适配器工件的区别,请阅读LoRA 与 QLoRA

来源

保留系列,清除冗余副本。免费下载 ↓