桌面應用
在 Windows 上安裝 ComfyUI 桌面版——最簡單的入門方式。
ComfyUI 桌面版是官方的一鍵安裝程序。它內置 Python，自動管理依賴項並處理更新。這是大多數用戶推薦的安裝方式。
請勿以管理員身份運行
安裝或啟動 ComfyUI 時，不要右鍵點擊 → "以管理員身份運行"。以管理員身份運行會導致 Python 包權限衝突，可能會破壞你的安裝。請使用普通用戶賬戶。
第 1 步：下載
從 ComfyUI 官方網站下載安裝程序：
comfy.org/download → 點擊 "Download for Windows (NVIDIA)"
下載文件是標準的 .exe 安裝程序，大約 100 MB。首次啟動將下載額外的依賴項（約 15 GB）。
第 2 步：安裝
- 雙擊下載的
.exe文件 - 按照 Windows 安裝嚮導提示操作
- 桌面上將創建一個 ComfyUI 快捷方式
第 3 步：首次啟動設置
雙擊桌面快捷方式啟動 ComfyUI。首次啟動會打開一個設置嚮導：
1. 歡迎界面
點擊 "Get Started" 開始。
2. GPU 選擇
選擇 NVIDIA（應該會被自動檢測到）。點擊 Next。
3. 安裝位置
選擇存儲 Python 環境、模型和自定義節點的位置。
提示
選擇至少有 50 GB 可用空間的驅動器。強烈建議使用 SSD 以加快模型加載速度。完整硬件建議請參閱系統要求。
4. 遷移（可選）
如果你已有 ComfyUI 安裝（便攜版或手動安裝），可以導入現有的：
- 模型和 checkpoints
- 自定義節點
- 工作流和設置
首次使用的用戶：留空並點擊 Next。
5. 桌面應用設置
配置：
- 自動更新 — 保持啟用
- 使用統計 — 可選，匿名分析數據
- 鏡像設置 — 如果你在中國或網絡連接較慢，請選擇替代鏡像
鏡像 URL 旁邊顯示綠色勾號表示連接正常。如果看到紅色 X，請嘗試其他鏡像。
6. 安裝完成
設置嚮導將下載並配置 Python 及所有依賴項。根據你的網速，這可能需要 5-15 分鐘。
完成後，ComfyUI 會自動啟動，你將看到節點編輯器界面。
更新
ComfyUI 桌面版在啟動時會自動檢查更新。你也可以通過應用菜單手動檢查。
卸載
通過 Windows 設置 → 應用 → ComfyUI 卸載。請注意，這會刪除應用，但可能會在安裝目錄中保留你的模型和自定義節點。如需徹底刪除，請手動刪除這些文件。
故障排查
| 問題 | 解決方案 |
|---|---|
| 安裝程序被殺毒軟件攔截 | 在殺毒軟件設置中為 ComfyUI 安裝程序添加例外 |
| "Unsupported device" 錯誤 | 你的 GPU 可能不支持 CUDA。查看 GPU 兼容性或嘗試使用便攜包搭配 --cpu 參數 |
| 鏡像連接失敗（紅色 X） | 嘗試其他鏡像，或檢查你的防火牆/代理設置 |
| 設置卡在 "Installing Python" | 檢查你的網絡連接。下載大小約 15 GB |
| 安裝後應用無法啟動 | 查看終端窗口中的錯誤日誌。參閱常見問題 |
文件位置
安裝後，你的文件結構如下：
[你的安裝目錄]/
├── python/ # 內置 Python（請勿修改）
├── ComfyUI/
│ ├── models/ # AI 模型存放位置
│ │ ├── checkpoints/ # 主模型文件
│ │ ├── loras/ # LoRA 文件
│ │ ├── vae/ # VAE 文件
│ │ └── ...
│ ├── custom_nodes/ # 社區插件
│ ├── input/ # 輸入圖片
│ └── output/ # 生成的圖片
└── resources/ # 應用內部文件（請勿修改）重要提示
切勿修改 python/ 或 resources/ 目錄中的文件。只操作 ComfyUI/ 文件夾中的內容。
下一步
先按上面的步驟定位根因。還卡住時，可以下載 Wonderful Launcher 檢查目前機器；啟動器原生修復、任務日誌和執行階段檢查會集中在一起。credits 只用於圖片生成和按量工具。
下載 Wonderful Launcher查看 credits 方案這篇文件解決了你的問題嗎？
你的回饋會幫助我們優先補強真實 ComfyUI 排障文件。