ComfyUI 模型路径未检测到：修复 extra_model_paths.yaml

如果您搜索的是 ComfyUI 模型路径未检测到、extra_model_paths.yaml 无法加载模型、ComfyUI 模型下拉列表为空 或 路径不存在，请先创建包含该路径的目录，请从这里开始。本页面针对的是模型文件已存在于磁盘上，但正在运行的 ComfyUI 进程未扫描包含该文件的文件夹这一情况。

额外模型路径的案例审查清单

本页面用于路径检测，而非软件包修复。当文件已存在于磁盘但 ComfyUI 未扫描包含它的文件夹时，请使用本页面。

如果工作流仍缺少自定义节点，请先修复这些问题。缺少的节点可能会隐藏后续的模型缺失错误，因为加载器永远不会注册。

搜索意图分类

问题表现

• "Load Checkpoint" 节点显示空下拉列表或未列出您的模型
• ComfyUI 启动成功，但模型选择中没有文件
• 您将模型添加到外部驱动器，但它们不显示
• 启动日志没有错误，但模型不可见

原因分析

• extra_model_paths.yaml 语法错误：YAML 对空白字符敏感。错误的缩进或制表符会静默破坏文件
• Windows 上路径分隔符错误：不加引号使用反斜杠可能破坏 YAML 解析
• 路径不存在：配置中指定的文件夹已被移动、重命名，或驱动器未挂载
• 子文件夹映射错误：YAML 键映射到错误的子文件夹名称
• 文件扩展名过滤：ComfyUI 查找特定扩展名（.safetensors、.ckpt、.pt、.pth），忽略其他文件
• 模型位于 models/ 根目录：文件必须在正确的子文件夹中，而不是直接放在 models/ 下

ComfyUI 如何查找模型

ComfyUI 在两个位置检查模型文件：

1. 默认文件夹：ComfyUI/models/<type>/（例如 ComfyUI/models/checkpoints/）
2. 额外路径：ComfyUI/extra_model_paths.yaml 中列出的文件夹

如果两个位置都不包含该模型，下拉列表将为空。

逐步修复

第 1 步：验证默认模型文件夹

检查文件是否在正确的子文件夹中：

dir ComfyUI\models\checkpoints\
dir ComfyUI\models\loras\

如果列出了您的模型文件，则问题不在路径。重启 ComfyUI 并再次检查。

第 2 步：检查 extra_model_paths.yaml

如果您使用外部模型文件夹，请打开 ComfyUI/extra_model_paths.yaml 并检查以下常见错误。在正常的 ComfyUI 检出中，首先复制或重命名 extra_model_paths.yaml.example 为 extra_model_paths.yaml。

正确格式：

my_models:
    base_path: D:/AI/models
    checkpoints: checkpoints/
    loras: loras/
    vae: vae/

常见错误：

# 错误：使用制表符而非空格
my_models:
	base_path: D:/AI/models    # 制表符——YAML 要求使用空格

# 错误：缺少尾部斜杠或分隔符错误
my_models:
    base_path: D:\AI\models    # 反斜杠可能导致问题
    checkpoints: checkpoints   # 缺少尾部斜杠（可能有效但不一致）

# 错误：路径不存在
my_models:
    base_path: E:/Models       # 驱动器 E: 未挂载或文件夹不存在

第 3 步：手动测试路径

验证完整路径存在并包含模型文件：

dir "D:\AI\models\checkpoints\"

如果显示您的模型文件，则路径正确。否则，修复文件夹结构。

第 4 步：检查 YAML 有效性

YAML 对格式要求严格。常见问题：

• 使用空格，而非制表符进行缩进（2 或 4 个空格）
• 在 Windows 路径中使用正斜杠：D:/AI/models 而非 D:\AI\models
• 引用含空格的路径：base_path: "D:/My Models/AI"
• 值后无尾部空格

第 5 步：重启 ComfyUI

ComfyUI 仅在启动时读取模型路径。更改 extra_model_paths.yaml 或添加模型文件后，必须重启：

.\python_embeded\python.exe -s ComfyUI\main.py --windows-standalone-build

注意启动日志中的任何 YAML 解析错误。

如果您有意将配置文件放在其他位置，请每次使用相同的额外模型路径配置启动 ComfyUI。ComfyUI 提供了 --extra-model-paths-config 参数用于加载一个或多个此类文件，但根目录下的单个 extra_model_paths.yaml 更易于验证。

第 6 步：检查启动日志中的路径扫描

ComfyUI 在启动时会记录它扫描的模型文件夹。查找提及您的外部路径的行，以确认它已被加载。

子文件夹映射参考

extra_model_paths.yaml 中的键必须与 ComfyUI 期望的模型类型名称匹配：

何时不应盲目运行 pip install

模型路径检测是配置问题，而非软件包问题。不要通过安装 Python 软件包来修复缺少的模型下拉列表。修复方法始终与文件路径和 YAML 配置有关。

验证清单

在确认路径已修复之前，请验证以下全部四项：

1. 重启后，默认 ComfyUI/models/ 文件夹下的文件出现。
2. 重启后，extra_model_paths.yaml 外部文件夹下的文件出现。
3. 活跃的 ComfyUI 文件夹与您编辑 extra_model_paths.yaml 的文件夹相同。
4. 加载器节点与模型类型匹配：检查点加载器用于检查点，LoRA 加载器用于 LoRA，ControlNet 加载器用于 ControlNet 模型，依此类推。

Wonderful Launcher 如何提供帮助

Wonderful Launcher 帮助管理模型路径。它提供可视化界面用于配置模型文件夹，在应用前验证路径，并支持跨多个驱动器存储的模型。

下载 Wonderful Launcher——免费使用，无需手动编辑 YAML。

相关错误

• ComfyUI 无法找到模型文件
• ComfyUI 检查点存储位置
• ComfyUI 中 safetensors 文件放在哪里
• 在 ComfyUI 中安装模型
• ComfyUI 工作流缺少节点

来源参考

• ComfyUI GitHub
• ComfyUI 官方模型故障排查
• ComfyUI extra_model_paths.yaml.example
• YAML 规范