ComfyUI 通过根目录下的 extra_model_paths.yaml 文件配置多模型路径，适合需要共享 Automatic1111 模型库或分散存储大型模型的场景。修改该文件前需备份，YAML 缩进错误会导致 ComfyUI 无法启动。

命令速用版

在 ComfyUI 根目录下执行以下命令，复制示例配置文件为正式配置文件：

cp extra_model_paths.yaml.example extra_model_paths.yaml

如果已存在该文件，直接编辑即可，无需每次启动都复制。

为什么会这样

ComfyUI 默认只扫描内部 models 文件夹，extra_model_paths.yaml 用于扩展搜索范围。该文件采用 YAML 格式，定义多个配置组，每个组指定一个 base_path 基础路径及其子目录映射。系统启动时读取该文件，将指定文件夹加入模型加载队列，实现多路径管理而不破坏原有目录结构。

分步处理

1. 定位文件：进入 ComfyUI 安装根目录，查找 extra_model_paths.yaml。如果不存在，按“命令速用版”复制示例文件。

2. 编辑配置：使用文本编辑器打开 extra_model_paths.yaml，找到 comfyanonymous 配置块或新建自定义块（如 my_models）。

3. 填写路径：修改 base_path 为绝对路径或相对路径，例如：

my_models:
  base_path: D:/AI_Models
  checkpoints: checkpoints
  loras: |   
    loras
    LyCORIS
  vae: vae

4. 保存文件：确保文件编码为 UTF-8，保存后关闭编辑器。

5. 风险边界：不要删除默认的 comfyanonymous 配置块，除非确认不需要内部 models 文件夹。

怎么验证是否生效

启动 ComfyUI，观察命令行控制台输出日志。搜索关键词"Adding extra search path"，确认日志中打印了你配置的路径。在前端界面点击模型加载节点，检查下拉列表是否包含外部路径中的模型文件。如果模型未显示，检查路径拼写和文件夹权限。

常见坑

1. 缩进错误：YAML 对缩进敏感，必须使用空格而非 Tab 键，层级错位会导致解析失败。

2. 路径不存在：配置的 base_path 或子目录如果物理上不存在，ComfyUI 通常会跳过该路径但不报错，导致模型不显示。

3. 键名错误：子目录键名必须匹配 ComfyUI 识别的类型（如 checkpoints、loras、vae），自定义键名无效。

4. 重复配置：多个配置块指向同一物理路径不会报错，但会增加扫描开销，建议合并配置。

常见问题

可以直接使用 Automatic1111 的模型路径吗

可以。在 extra_model_paths.yaml 中启用 a1111 配置块，将 base_path 指向 Automatic1111 的安装目录，ComfyUI 会自动读取其 models 文件夹。

修改配置后需要重启 ComfyUI 吗

需要。extra_model_paths.yaml 仅在 ComfyUI 启动时加载，修改后必须完全关闭并重新启动进程才能生效。

相对路径和绝对路径哪个更好

相对路径更适合迁移，绝对路径更稳定。如果 ComfyUI 目录位置固定，建议使用绝对路径避免工作目录变化导致路径失效。

参考来源

1. 来源名：GitHub - comfyanonymous/ComfyUI
页面标题：extra_model_paths.yaml.example
URL：https://github.com/comfyanonymous/ComfyUI/blob/master/extra_model_paths.yaml.example