如何修復 ComfyUI 找不到模型檔案的問題
修復 ComfyUI 找不到模型、checkpoint、LoRA、VAE、ControlNet 或 safetensors 檔案的問題：模型尚未下載、放錯資料夾，或模型路徑沒有設定好。
當你執行 ComfyUI 工作流程時，如果看到紅色節點、模型下拉選單是空的，或出現 "Model not found" / "Checkpoint not found"，意思是：ComfyUI 看不到這個工作流程需要的模型檔案。
這通常不是檔案損壞。最常見的原因是模型還沒下載、放錯資料夾，或你把檔案放進了另一個 ComfyUI 安裝目錄。
先選一個最像你目前狀況的情境。
你現在是哪種情況？
情境 A：執行時提示模型缺失，或模型下拉選單是空的
你匯入別人分享的工作流程，按下 Queue Prompt 後看到 X required models are missing、Checkpoint not found，或載入器的模型下拉選單裡沒有可選項目。
╭─────────────────────────╮
│ 🔴 Load Checkpoint │
├─────────────────────────┤
│ ckpt_name │
│ ╭─────────────────────╮ │
│ │ [Empty / None] ▼ │ │
│ ╰─────────────────────╯ │
╰─────────────────────────╯👉 可能原因：你還沒下載這個模型，或下載了但沒有放進 ComfyUI 會掃描的資料夾。 🔗 跳到解法：下載並放到正確資料夾
情境 B：你確定下載過模型，但 ComfyUI 還是找不到
你能在電腦裡看到這個檔案，但 ComfyUI 節點下拉選單裡沒有它，或執行時仍然報找不到。
👉 可能原因：檔案放錯模型子資料夾、放在其他硬碟但沒有設定 extra_model_paths.yaml，或你放進了另一個 ComfyUI 安裝目錄。
🔗 跳到解法：檢查資料夾位置與路徑設定
情境 C：資料夾裡看得到模型，但工作流程還是失敗
你打開正確資料夾，模型檔案確實在裡面，但 ComfyUI 報錯 Value not in list: ckpt_name: 'xxx.safetensors' not in []。
👉 可能原因：工作流程儲存的檔名和你本機檔名不同、檔案下載不完整，或載入器需要的是另一種模型類型。 🔗 跳到解法：檢查檔名匹配與檔案完整性
不確定是不是模型問題？先看這裡
先對照這張表，避免修錯方向。
| 你看到的現象 | 實際含義 | 應該去哪裡 |
|---|---|---|
Value not in list: ckpt_name: '...' not in [] | 載入器存在，但選中的模型檔案不可見 | 就是本文，繼續往下看 |
| 報錯裡出現 LoRA、VAE、CLIP、ControlNet、IPAdapter、checkpoint 或 safetensors 檔名 | 工作流程正在請求某個模型資源 | 就是本文，繼續往下看 |
紅色節點提示 Unknown class_type 或 class_type not found | 節點本身沒有安裝，不是模型檔問題 | 工作流程缺少節點 |
啟動紀錄出現 IMPORT FAILED 或 No module named ... | 外掛後端沒有成功匯入 | 外掛匯入失敗 或 No module named 錯誤 |
| 資料夾裡看得到模型，但下拉選單裡看不到 | ComfyUI 可能正在掃描另一個模型資料夾 | 模型路徑未偵測到 |
ComfyUI 的驗證錯誤通常長這樣：
Prompt outputs failed validation:
CheckpointLoaderSimple:
- Value not in list: ckpt_name: 'model-name.safetensors' not in []情境 A：下載並放到正確資料夾
別人分享的工作流程通常不會附上模型檔案。你需要先取得對應模型檔，再把它放到載入器會讀取的位置。
Wonderful Launcher 快速方案
如果缺少的模型在 Wonderful Launcher 的模型庫裡，可以直接在 Launcher 內搜尋並下載。Launcher 會把模型庫下載的檔案儲存到對應的 ComfyUI 模型資料夾，減少你手動猜資料夾的時間。
私有模型、改過名的檔案，或模型庫裡沒有的檔案，仍然可能需要下面的手動檢查。
手動步驟：
- 先確認缺哪個檔案：看紅色節點、驗證錯誤，或缺失模型通知裡的檔名。例如
v1-5-pruned-emaonly.safetensors。 - 下載那個精確檔案：常見來源是 Hugging Face 或 Civitai。如果工作流程作者寫了具體模型名，優先找同名檔案。
- 放進對應子資料夾：這一步最容易出錯。
常見的 ComfyUI 模型資料夾：
ComfyUI/
└── models/
├── checkpoints/ ← SD 1.5 / SDXL checkpoint
├── loras/ ← LoRA 檔案
├── vae/ ← VAE 檔案
├── clip/ ← 部分載入器使用的 CLIP 檔案
├── text_encoders/ ← 新工作流程常用的文字編碼器
├── controlnet/ ← ControlNet 模型
├── upscale_models/ ← ESRGAN 等放大模型
├── embeddings/ ← Textual Inversion embedding
├── clip_vision/ ← IP-Adapter 用的 CLIP Vision
├── ipadapter/ ← IP-Adapter 模型
├── diffusion_models/ ← 獨立 diffusion / UNet 模型
├── unet/ ← 舊版或自訂節點使用的 UNet 目錄
└── sams/ ← Segment Anything 模型快速判斷
先看節點名稱。Load LoRA 通常讀 models/loras/；Load Checkpoint 通常讀 models/checkpoints/；ControlNet 載入器通常讀 models/controlnet/。
- 刷新 ComfyUI：如果介面有模型刷新按鈕，按一下；否則完整重啟 ComfyUI，讓它重新掃描資料夾。
也可以用 PowerShell 檢查某個資料夾：
dir ComfyUI\models\checkpoints\把 checkpoints 換成目前載入器對應的子資料夾。
情境 B：檢查資料夾位置與路徑設定
如果你確定模型已經在電腦裡，先做簡單檢查，再考慮改設定。
Wonderful Launcher 本機檔案拖放方案
如果同時符合下面兩個條件，Wonderful Launcher 通常可以幫你把檔案歸位：
- 目前工作流程已經顯示缺失模型通知。
- 你手上的本機檔名，和工作流程缺失的檔名完全一致。
把下載好的模型檔拖到 Launcher 頂部通知列裡的虛線區域。Launcher 會根據缺失模型資訊規劃目標資料夾。如果匹配不明確、路徑不安全或找不到對應關係，它不會偷偷亂放。
手動檢查：
第一步：確認模型在正確子資料夾
最常見的錯誤是把 LoRA 放進 checkpoints/，或把 checkpoint 放進 loras/。
✗ 錯誤：
ComfyUI/models/checkpoints/my_lora.safetensors
✓ 正確：
ComfyUI/models/loras/my_lora.safetensors對照情境 A 的資料夾表，把檔案類型和載入器配起來。
第二步：確認你放進的是正在執行的 ComfyUI
如果你有多個 ComfyUI，例如 portable 版、Git 安裝版、Launcher 管理的版本或其他整合包，先確認目前執行的是哪一個。
一個簡單線索是看 ComfyUI 啟動時主控台顯示的路徑。先確認路徑，再移動檔案。
第三步：模型在其他硬碟？設定外部路徑
只有當模型放在 ComfyUI 目錄外，例如 D:/AI/models/，才需要這一步。
- 在 ComfyUI 根目錄找到
extra_model_paths.yaml.example。 - 複製或重新命名為
extra_model_paths.yaml。 - 修改路徑，例如：
my_models:
base_path: D:/AI/models/
checkpoints: checkpoints/
loras: loras/
vae: vae/
controlnet: controlnet/- 儲存檔案，並完整重啟 ComfyUI。
如果你用自訂設定路徑啟動 ComfyUI，要確認目前行程載入的是同一個設定檔。較新的 ComfyUI 也支援 --extra-model-paths-config 來載入一個或多個額外模型路徑檔，但大多數使用者先從 ComfyUI 資料夾裡的 extra_model_paths.yaml 開始就夠了。
情境 C：檢查檔名匹配與檔案完整性
如果模型在正確資料夾裡，但工作流程仍然失敗，重點看這兩件事。
1. 檔名和工作流程儲存的不一致
工作流程裡儲存的是原作者當時選的模型名。比如它要的是 sdxl_base_1.0.safetensors，但你本機檔案叫 sdxl_base.safetensors，ComfyUI 會把它們當成兩個不同選項。
╭─────────────────────────╮
│ 🔴 Load Checkpoint │
├─────────────────────────┤
│ ckpt_name │
│ ╭─────────────────────╮ │
│ │ sdxl_base_1.0... ▼ │ │ ← 缺的就是這個精確名稱
│ ╰─────────────────────╯ │
╰─────────────────────────╯解法：打開節點的模型下拉選單，重新選中你本機實際存在的檔名。重新命名檔案有時也能用，但直接在節點裡選本機檔案通常更穩。
2. 模型沒有下載完整
模型檔案很大。瀏覽器下載失敗、代理中斷，都可能留下很小的殘缺檔。
如果一個本來應該幾 GB 的模型，在你電腦上只有幾 KB 或幾百 MB，刪掉它重新下載。不要把 Windows 的 .lnk 捷徑當作模型檔；ComfyUI 需要真正的模型檔，或正確設定好的模型路徑。
不要用 pip install 修這個問題
模型找不到，通常不是 Python 套件缺失。如果問題是 .safetensors、.ckpt、.gguf、.pt、.pth、.bin 或 .onnx 檔案缺失/放錯位置，pip install 完全是錯方向。
修好了？先確認這幾件事
移動、下載或設定模型之後，先別急著收工：
- 刷新或重啟 ComfyUI，讓它重新掃描模型資料夾。
- 重新排隊工作流程，看原本的紅色節點是否消失。
- 繼續看下一個缺失模型。一個工作流程可能缺好幾個檔案，修完第一個冒出第二個很正常。
- 確認模型類型匹配。如果檔案出現在下拉選單裡但執行仍失敗，工作流程可能需要另一個 checkpoint、LoRA、VAE、ControlNet、diffusion model、text encoder 或 GGUF 檔案。
下次不想再手動找資料夾？
如果你常常匯入工作流程，然後花時間找模型、對資料夾、修外部路徑，可以試試 下載 Wonderful Launcher。它不能讓所有私有模型憑空出現，但對支援的工作流程和模型來源，可以少掉很多手動猜路徑的步驟。
相關指南
來源參考
先按上面的步驟定位根因。還卡住時，可以下載 Wonderful Launcher 檢查目前機器；啟動器原生修復、任務日誌和執行階段檢查會集中在一起。credits 只用於圖片生成和按量工具。
下載 Wonderful Launcher查看 credits 方案這篇文件解決了你的問題嗎？
你的回饋會幫助我們優先補強真實 ComfyUI 排障文件。