ComfyUI でモデルのパスが検出されない：extra_model_paths.yaml の設定と修復
ComfyUI でモデルのパスが検出されない問題、extra_model_paths.yaml の記述エラー、Windows でのパス記述形式、モデルの選択肢が空になる現象の解決手順。
コミュニティナレッジ
本ページの内容は一般的な ComfyUI の構成に基づいており、すべての個別環境で動作を保証するものではありません。設定を変更する前に、必ず元のファイルをバックアップしてください。
モデルファイル自体はローカルディスク（外部 HDD / SSD 等）に保存してあるにもかかわらず、ComfyUI のモデル選択ドロップダウンメニュー（Load Checkpoint 等）に選択肢が表示されない、あるいは extra_model_paths.yaml の読み込みエラーが発生する場合は、以下の手順に従って構成を確認してください。
クイック回答
- モデルが
ComfyUI/models/内の正しい名前のサブフォルダに配置されているか確認します。 - 外部ドライブのパスを指定する場合は、
extra_model_paths.yamlのインデント語法およびパスの区切り文字を確認します。 - 重要：パス設定を変更した後は、必ず ComfyUI を再起動してください（モデルフォルダの走査は起動時にのみ実行されます）。
外部モデルパスの点検チェックリスト
| 点検項目 | 正常な状態 | 異常時の対策 |
|---|---|---|
編集している extra_model_paths.yaml が現在起動中の ComfyUI のものである | コンソールログの起動パスと一致している | 複製元のバックアップではなく、実際に稼働しているフォルダ内のファイルを編集する |
extra_model_paths.yaml が ComfyUI のルートに置かれている | main.py と同じ階層にある（models/ の中ではない） | まず extra_model_paths.yaml.example をコピーしてリネームする |
| YAML ファイル内でインデントにタブを使用していない | すべて半角スペースでインデントされている | タブ文字を半角スペースに置換する |
パス区切り文字にバックスラッシュ（\）を使用していない | スラッシュ（/）を使用している | D:/AI/models のようにスラッシュで書き換える |
| ドライブレターが正しく、フォルダ構造が合っている | 指定の外部パス直下に checkpoints/ などのフォルダがある | ドライブが接続されているか、フォルダ名が正しいか確認する |
原因分析
- YAML の構文エラー：YAML はインデント（空白）に非常に厳格です。タブ文字（Tab）が混入していると読み込みに失敗します。
- パス区切り文字のエラー：Windows 標準のバックスラッシュ（
\）はエスケープシーケンスと誤認されやすいため、スラッシュ（/）を使用する必要があります。 - ドライブ未接続：外付けドライブが別のドライブレター（例：EドライブからFドライブへ）に変更されている。
- モデルを
models/直下に置いている：モデルファイルは必ずcheckpoints/やloras/などの各サブフォルダ内に置く必要があり、ルート直下に置いても認識されません。
解決手順
ステップ 1：デフォルトのモデルフォルダ構造の確認
標準の配置ディレクトリにファイルがあるか確認します：
dir ComfyUI\models\checkpoints\
dir ComfyUI\models\loras\ファイルがここにあるのに認識されない場合は、ComfyUI の再起動を行ってください。
ステップ 2：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 # タブ文字が混入している（エラーになります）
# 誤り：バックスラッシュの使用、サブフォルダのスラッシュ不足
my_models:
base_path: D:\AI\models # バックスラッシュは不可
checkpoints: checkpoints # 末尾のスラッシュが無い
# 誤り：存在しないドライブの指定
my_models:
base_path: E:/Models # 外付けドライブ E: が認識されていないステップ 3：パスの存在確認
PowerShell を開き、指定したパスがシステムから正常に読み込めるかテストします：
dir "D:\AI\models\checkpoints\"ステップ 4：YAML 記述の修正
YAML 規則に従って以下を修正します：
- インデントは半角スペース2つ、または4つを使用します。
- Windows のパス記述であっても、スラッシュ（
/）を使用します。 - パス名に半角スペースが含まれる場合は、ダブルクォーテーションで囲みます：
base_path: "D:/My Models/AI"
ステップ 5：ComfyUI の完全再起動
変更を反映させるには、ComfyUI サーバープロセスを完全に再起動する必要があります：
.\python_embeded\python.exe -s ComfyUI\main.py --windows-standalone-build起動ログに YAML のパースエラー（解析エラー）が出ていないか確認してください。
関連ガイド
実際の ComfyUI 環境で起きている問題なら、まず無料で Wonderful Launcher を使って確認してください。ランチャー内の修復フロー、タスクログ、実行環境チェックを一か所で確認できます。クレジットは画像生成と従量ツール用です。
Wonderful Launcher をダウンロードクレジットプランを見るDid this fix your issue?
Your answer helps prioritize verified ComfyUI repairs.