ComfyUI 模型路徑未偵測到：修復 extra_model_paths.yaml

如果您搜尋的是 ComfyUI 模型路徑未偵測到、extra_model_paths.yaml 無法載入模型、ComfyUI 模型下拉式選單為空 或 路徑不存在，請先建立包含該路徑的目錄，請從這裡開始。本頁面針對的是模型檔案已存在於磁碟上，但正在運行的 ComfyUI 程序未掃描包含該檔案的資料夾這一情況。

額外模型路徑的案例審查清單

本頁面用於路徑偵測，而非軟體套件修復。當檔案已存在於磁碟但 ComfyUI 未掃描包含它的資料夾時，請使用本頁面。

如果工作流仍缺少自定義節點，請先修復這些問題。缺少的節點可能會隱藏後續的模型缺失錯誤，因為載入器永遠不會註冊。

搜尋意圖分類

原因分析

• extra_model_paths.yaml 語法錯誤：YAML 對空白字元敏感。錯誤的縮排或定位字元（Tab）會靜默破壞檔案
• Windows 上路徑分隔符號錯誤：不加引號使用反斜線可能破壞 YAML 解析
• 路徑不存在：配置中指定的資料夾已被移動、重新命名，或磁碟機未掛載
• 子資料夾映射錯誤：YAML 鍵映射到錯誤的子資料夾名稱
• 模型位於 models/ 根目錄：檔案必須在正確的子資料夾中，而不是直接放在 models/ 下

逐步修復

第 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/

常見錯誤：

# 錯誤：使用定位字元（Tab）而非空格
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 對格式要求嚴格。常見問題：

• **使用空格，而非定位字元（Tab）**進行縮排（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

相關指南

• ComfyUI 無法找到模型檔案
• ComfyUI 檢查點儲存位置
• ComfyUI 中 safetensors 檔案放在哪裡
• 在 ComfyUI 中安裝模型
• ComfyUI 工作流缺少節點