在 Stable Diffusion 生態(tài)中WebUI 以其直觀的圖形界面長(zhǎng)期占據(jù)主流但對(duì)于追求更高自定義程度、更穩(wěn)定工作流和更強(qiáng)性能控制的用戶來(lái)說(shuō)ComfyUI 是一個(gè)繞不開(kāi)的選擇。它采用節(jié)點(diǎn)式編程界面將 AI 圖像生成的每一個(gè)步驟都可視化、模塊化這種設(shè)計(jì)不僅讓生成過(guò)程變得透明可控更在批量處理、復(fù)雜工作流編排和資源管理上展現(xiàn)出巨大優(yōu)勢(shì)。然而其相對(duì)“硬核”的界面和依賴(lài)項(xiàng)配置也讓許多新手在第一步“安裝”上就望而卻步。網(wǎng)絡(luò)上流傳的整合包、一鍵安裝腳本雖然降低了門(mén)檻但也帶來(lái)了版本混亂、依賴(lài)沖突、插件管理困難等問(wèn)題。本文將圍繞 ComfyUI 的安裝提供一個(gè)清晰、可復(fù)現(xiàn)的路徑。我們不會(huì)只給一個(gè)“萬(wàn)能”整合包的下載鏈接而是會(huì)從底層原理講起讓你理解 ComfyUI 運(yùn)行需要什么然后分別介紹從零開(kāi)始的“純凈安裝”和使用“秋葉aaaki整合包”的“便捷安裝”兩種主流方案。無(wú)論你是想徹底掌控自己的 AI 繪畫(huà)環(huán)境還是希望快速上手體驗(yàn)都能找到對(duì)應(yīng)的步驟。更重要的是我們會(huì)詳細(xì)說(shuō)明安裝后的關(guān)鍵配置、模型放置、插件管理以及如何驗(yàn)證安裝成功并附上從環(huán)境變量到端口沖突等一系列常見(jiàn)問(wèn)題的排查清單。目標(biāo)是讓你不僅能把 ComfyUI 跑起來(lái)更能理解它為什么能跑起來(lái)為后續(xù)深入學(xué)習(xí)工作流打下堅(jiān)實(shí)基礎(chǔ)。1. 理解 ComfyUI節(jié)點(diǎn)式工作流引擎與安裝核心依賴(lài)在動(dòng)手安裝之前先理解 ComfyUI 是什么以及它依賴(lài)什么能有效避免后續(xù)很多“知其然不知其所以然”的困惑。1.1 ComfyUI 的核心設(shè)計(jì)可視化節(jié)點(diǎn)編程ComfyUI 不是一個(gè)帶有預(yù)設(shè)按鈕的圖形界面而是一個(gè)可視化編程環(huán)境。它將 Stable Diffusion 模型推理的每一個(gè)步驟——如加載模型、編碼提示詞、采樣、解碼——都抽象成獨(dú)立的“節(jié)點(diǎn)”。用戶通過(guò)連接這些節(jié)點(diǎn)的輸入輸出端口來(lái)構(gòu)建一個(gè)完整的圖像生成“工作流”。這種設(shè)計(jì)的優(yōu)勢(shì)在于完全透明你可以清晰看到 latent space 如何一步步轉(zhuǎn)化為最終圖像便于調(diào)試和優(yōu)化。極致靈活可以自由組合、循環(huán)、分支實(shí)現(xiàn)文生圖、圖生圖、高清修復(fù)、ControlNet 控制等復(fù)雜流程甚至超越常規(guī) UI 的功能?？蓮?fù)用與分享工作流可以保存為.json或.png文件他人導(dǎo)入后能完全復(fù)現(xiàn)你的生成過(guò)程包括所有參數(shù)。資源高效由于流程固定ComfyUI 在連續(xù)生成時(shí)無(wú)需重復(fù)加載模型內(nèi)存管理更高效適合批量作業(yè)。1.2 安裝前的必備認(rèn)知Python、Git 與 PyTorchComfyUI 本身是一個(gè) Python 應(yīng)用程序。因此它的運(yùn)行離不開(kāi) Python 環(huán)境。網(wǎng)絡(luò)上所有的整合包其核心工作就是為你預(yù)先配置好一個(gè)包含正確版本 Python 和相關(guān)庫(kù)的隔離環(huán)境。Python是 ComfyUI 的運(yùn)行時(shí)。必須安裝特定版本通常為 3.10 或 3.11版本不匹配會(huì)導(dǎo)致依賴(lài)庫(kù)安裝失敗。Git用于克隆 ComfyUI 的源代碼倉(cāng)庫(kù)以及后續(xù)安裝和管理插件很多插件也托管在 GitHub 上。雖然整合包可能內(nèi)置但自己安裝 Git 是良好的開(kāi)發(fā)習(xí)慣。PyTorch這是深度學(xué)習(xí)框架是 Stable Diffusion 模型運(yùn)行的引擎。PyTorch 版本必須與你的顯卡驅(qū)動(dòng)和 CUDA 版本嚴(yán)格匹配否則無(wú)法調(diào)用 GPU 進(jìn)行加速會(huì)退回到極慢的 CPU 模式。依賴(lài)庫(kù)包括torchvision,transformers,accelerate等數(shù)十個(gè) Python 包它們提供了模型加載、數(shù)據(jù)處理、性能優(yōu)化等功能。“純凈安裝”需要你手動(dòng)處理以上所有依賴(lài)的版本協(xié)調(diào)而“整合包安裝”則替你完成了這一步。下面我們將分兩條路徑展開(kāi)。2. 方案一純凈安裝 ComfyUI適合開(kāi)發(fā)者與追求可控性的用戶這條路徑讓你完全掌控環(huán)境便于后續(xù)開(kāi)發(fā)插件或深度定制。它更接近軟件開(kāi)發(fā)的原始流程。2.1 環(huán)境準(zhǔn)備安裝 Python、Git 與 CUDA首先確保你的系統(tǒng)滿足以下基礎(chǔ)要求組件要求檢查/安裝方法操作系統(tǒng)Windows 10/11, Linux 或 macOS系統(tǒng)信息顯卡NVIDIA GPU (推薦) 或 AMD GPU (通過(guò)ROCm) 或僅CPU設(shè)備管理器或nvidia-smi(Linux)Python3.10 或 3.11(3.12可能存在兼容性問(wèn)題)訪問(wèn) python.org 下載安裝包。安裝時(shí)務(wù)必勾選 “Add Python to PATH”。安裝后在終端輸入python --version驗(yàn)證。Git最新版即可訪問(wèn) git-scm.com 下載安裝。安裝后在終端輸入git --version驗(yàn)證。CUDA(NVIDIA)版本需與 PyTorch 匹配查看 PyTorch 官網(wǎng) 獲取推薦版本?？赏ㄟ^(guò)nvidia-smi查看驅(qū)動(dòng)支持的最高 CUDA 版本。注意Python 版本是第一個(gè)關(guān)鍵點(diǎn)。很多整合包問(wèn)題源于使用了不兼容的 Python 版本。如果你系統(tǒng)已有其他 Python 版本強(qiáng)烈建議使用conda或venv創(chuàng)建獨(dú)立的虛擬環(huán)境。2.2 獲取 ComfyUI 源代碼與創(chuàng)建虛擬環(huán)境我們使用 Git 克隆代碼并用 Python 內(nèi)置的venv創(chuàng)建隔離環(huán)境。打開(kāi)終端Windows 用 PowerShell 或 CMD建議管理員模式。選擇一個(gè)合適的目錄例如D:\AI\ComfyUI然后在此目錄打開(kāi)終端?？寺}(cāng)庫(kù)git clone https://github.com/comfyanonymous/ComfyUI.git cd ComfyUI創(chuàng)建并激活虛擬環(huán)境# 創(chuàng)建虛擬環(huán)境環(huán)境文件會(huì)保存在當(dāng)前目錄下的 venv 文件夾 python -m venv venv # 激活虛擬環(huán)境 # Windows (PowerShell) .\venv\Scripts\Activate.ps1 # Windows (CMD) .\venv\Scripts\activate.bat # Linux/macOS source venv/bin/activate激活后終端提示符前會(huì)出現(xiàn)(venv)字樣表示后續(xù)所有 Python 操作都局限在此環(huán)境中。2.3 安裝 PyTorch 及其他依賴(lài)這是最易出錯(cuò)的步驟核心是安裝與你的 CUDA 版本匹配的 PyTorch。確定 PyTorch 安裝命令。訪問(wèn) PyTorch 官網(wǎng) 根據(jù)你的系統(tǒng)、包管理工具pip、CUDA 版本生成安裝命令。例如對(duì)于 Windows、CUDA 11.8命令可能如下pip3 install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118如果你的顯卡不支持 CUDA 或只想用 CPU則選擇 CUDA 版本為 “CPU”。在激活的(venv)環(huán)境中執(zhí)行上一步獲取的 PyTorch 安裝命令。安裝 ComfyUI 的其他依賴(lài)。在 ComfyUI 代碼根目錄下通常有一個(gè)requirements.txt文件pip install -r requirements.txt這個(gè)過(guò)程會(huì)下載安裝數(shù)十個(gè)依賴(lài)包需要一定時(shí)間。2.4 下載模型并放置到正確位置ComfyUI 不會(huì)自帶任何模型。你需要將已有的 Stable Diffusion 模型文件放入指定文件夾。準(zhǔn)備模型文件你需要至少一個(gè)基礎(chǔ)檢查點(diǎn)模型如sd_xl_base_1.0.safetensors通常從 CivitAI 或 Hugging Face 下載。了解模型目錄結(jié)構(gòu)ComfyUI 啟動(dòng)時(shí)會(huì)掃描以下文件夾相對(duì)于 ComfyUI 根目錄models/checkpoints/存放基礎(chǔ)模型.ckpt,.safetensors。models/vae/存放 VAE 模型。models/loras/存放 LoRA 模型。models/controlnet/存放 ControlNet 模型。models/upscale_models/存放超分辨率模型如 ESRGAN。input/存放用于圖生圖的輸入圖片。output/ComfyUI 默認(rèn)輸出圖片的文件夾。放置模型將下載的模型文件放入對(duì)應(yīng)的文件夾。例如將sd_xl_base_1.0.safetensors放入ComfyUI/models/checkpoints/。2.5 啟動(dòng)與驗(yàn)證安裝完成以上步驟后就可以啟動(dòng) ComfyUI 了。啟動(dòng)服務(wù)。在 ComfyUI 根目錄的激活虛擬環(huán)境下運(yùn)行python main.py如果一切順利你將看到類(lèi)似下面的輸出表明服務(wù)已啟動(dòng)ComfyUI startup time: 2.6s To see the GUI go to: http://127.0.0.1:8188訪問(wèn) Web UI。打開(kāi)瀏覽器訪問(wèn)http://127.0.0.1:8188。你應(yīng)該能看到一個(gè)空白的節(jié)點(diǎn)編輯器界面。加載一個(gè)簡(jiǎn)單工作流。為了驗(yàn)證模型加載和生成功能正常你可以右鍵點(diǎn)擊畫(huà)布 -Load-Default加載一個(gè)默認(rèn)的工作流。確保Checkpoint Loader節(jié)點(diǎn)中的模型名稱(chēng)是你已放入checkpoints文件夾的模型。點(diǎn)擊Queue Prompt按鈕。如果看到進(jìn)度條走動(dòng)并最終在Save Image節(jié)點(diǎn)看到生成的圖片說(shuō)明安裝完全成功。3. 方案二使用秋葉aaaki整合包安裝適合新手快速上手“秋葉aaaki”發(fā)布的整合包在社區(qū)內(nèi)非常流行它集成了 Python、Git、預(yù)配置的依賴(lài)庫(kù)、常用插件以及一個(gè)啟動(dòng)器極大簡(jiǎn)化了安裝過(guò)程。3.1 獲取整合包與注意事項(xiàng)獲取整合包通過(guò)可靠的渠道如秋葉的B站視頻簡(jiǎn)介、GitHub倉(cāng)庫(kù)或AI社區(qū)下載最新的整合包。注意核對(duì)發(fā)布日期和版本例如“2026整合包”是一個(gè)未來(lái)版本代號(hào)實(shí)際應(yīng)下載當(dāng)前最新的穩(wěn)定版。防病毒軟件誤報(bào)由于整合包內(nèi)包含 Python 可執(zhí)行文件、腳本和機(jī)器學(xué)習(xí)模型非常容易被 Windows Defender 或其他殺毒軟件誤報(bào)為病毒。在下載和解壓前建議暫時(shí)關(guān)閉實(shí)時(shí)防護(hù)或?qū)⒔鈮耗夸浱砑拥綒⒍拒浖呐懦斜怼Ｄ夸浡窂浇鈮赫习揭粋€(gè)英文路徑且路徑中不要有空格或特殊字符。例如D:\AI\ComfyUI-aki。中文路徑可能導(dǎo)致某些插件或腳本運(yùn)行異常。3.2 整合包目錄結(jié)構(gòu)與啟動(dòng)解壓后你會(huì)看到類(lèi)似如下的結(jié)構(gòu)ComfyUI-aki/ ├── ComfyUI/ # ComfyUI 主程序目錄 ├── python_embeded/ # 內(nèi)置的 Python 環(huán)境 ├── update/ # 更新腳本 ├── 啟動(dòng)器.exe # 圖形化啟動(dòng)器 └── 其他說(shuō)明文件.txt核心啟動(dòng)方式使用啟動(dòng)器推薦雙擊啟動(dòng)器.exe。啟動(dòng)器界面通常提供一鍵啟動(dòng)直接啟動(dòng) ComfyUI。高級(jí)選項(xiàng)設(shè)置監(jiān)聽(tīng)端口、自定義參數(shù)、清理空間等。插件管理安裝、更新、禁用社區(qū)插件。版本更新更新 ComfyUI 本體和內(nèi)置插件。使用腳本啟動(dòng)如果啟動(dòng)器有問(wèn)題可以進(jìn)入ComfyUI目錄直接運(yùn)行run_nvidia_gpu.batN卡或run_cpu.batCPU。3.3 整合包的特有配置與模型管理整合包的優(yōu)勢(shì)在于開(kāi)箱即用但仍需進(jìn)行一些初始配置。模型路徑配置整合包通常預(yù)置了模型目錄。但你的模型可能放在其他位置如原先 Stable Diffusion WebUI 的models目錄。你可以通過(guò)修改配置文件來(lái)添加模型路徑避免重復(fù)下載。找到ComfyUI目錄下的extra_model_paths.yaml.example文件。復(fù)制一份并重命名為extra_model_paths.yaml。用文本編輯器打開(kāi)參考示例格式添加你的模型路徑。例如a111: base_path: D:/sd-webui/models # 你的 WebUI 模型根目錄 checkpoints: Stable-diffusion vae: VAE loras: Lora upscale_models: ESRGAN保存后重啟 ComfyUI它就會(huì)同時(shí)從內(nèi)置目錄和你的自定義目錄加載模型。插件安裝整合包自帶了一些常用插件。通過(guò)啟動(dòng)器的“插件管理”功能可以方便地瀏覽、安裝新插件。安裝后通常需要重啟 ComfyUI。4. 安裝后的關(guān)鍵配置與驗(yàn)證無(wú)論采用哪種安裝方式成功啟動(dòng)后以下配置和驗(yàn)證步驟能確保你更好地使用 ComfyUI。4.1 基礎(chǔ)配置與優(yōu)化修改默認(rèn)端口如果 8188 端口被占用可以通過(guò)啟動(dòng)參數(shù)修改。在啟動(dòng)命令后添加--port 8189例如在run_nvidia_gpu.bat中修改python main.py為python main.py --port 8189。啟用跨域訪問(wèn)如果你需要通過(guò)局域網(wǎng)其他設(shè)備訪問(wèn)需要允許跨域。添加參數(shù)--enable-cors-header。性能調(diào)優(yōu)VRAM 優(yōu)化對(duì)于顯存較小的顯卡如 8GB可以在啟動(dòng)參數(shù)中添加--lowvram或--normalvram。整合包啟動(dòng)器通常提供選項(xiàng)。使用 xFormersxFormers 可以優(yōu)化注意力機(jī)制提升生成速度并降低顯存占用。整合包通常已集成。純凈安裝需運(yùn)行pip install xformers并在啟動(dòng)命令添加--use-split-cross-attention或--use-pytorch-cross-attention。工作流與模型管理導(dǎo)入工作流將下載的.json或.png工作流文件拖入 ComfyUI 瀏覽器界面即可加載。安裝自定義節(jié)點(diǎn)插件除了通過(guò)整合包啟動(dòng)器還可以通過(guò) ComfyUI 內(nèi)置的 “Manager” 插件如果已安裝進(jìn)行管理或手動(dòng)將插件克隆到ComfyUI/custom_nodes/目錄下。4.2 驗(yàn)證安裝完整性一個(gè)完整的 ComfyUI 環(huán)境應(yīng)能順利執(zhí)行以下操作鏈你可以據(jù)此檢查服務(wù)正常啟動(dòng)無(wú)紅色錯(cuò)誤日志輸出訪問(wèn)地址。界面正常加載瀏覽器訪問(wèn)端口出現(xiàn)節(jié)點(diǎn)編輯器界面。模型正常加載在Checkpoint Loader節(jié)點(diǎn)中能看到你放置在models/checkpoints/下的模型列表。簡(jiǎn)單圖生文成功加載默認(rèn)工作流填入提示詞點(diǎn)擊生成能輸出圖片到output文件夾。GPU 調(diào)用正常在生成過(guò)程中通過(guò)任務(wù)管理器Windows或nvidia-smiLinux查看 GPU 使用率是否顯著上升。如果一直是 CPU 高負(fù)載而 GPU 閑置說(shuō)明 PyTorch 的 CUDA 版本未正確安裝。5. 常見(jiàn)問(wèn)題排查清單安裝和運(yùn)行 ComfyUI 時(shí)90%的問(wèn)題可以通過(guò)以下清單解決。問(wèn)題現(xiàn)象可能原因檢查與解決步驟啟動(dòng)時(shí)報(bào)Python找不到或版本錯(cuò)誤1. Python未安裝或未添加到PATH。2. 多個(gè)Python版本沖突。1. 終端輸入python --version確認(rèn)版本是否為3.10/3.11。2. 使用虛擬環(huán)境(venv)隔離確保激活。啟動(dòng)時(shí)報(bào)torch相關(guān)錯(cuò)誤或CUDA不可用1. PyTorch版本與CUDA版本不匹配。2. 未安裝GPU版本的PyTorch。1. 在Python環(huán)境中運(yùn)行python -c import torch; print(torch.__version__); print(torch.cuda.is_available())。2. 若輸出False去PyTorch官網(wǎng)重裝對(duì)應(yīng)CUDA版本的PyTorch。啟動(dòng)時(shí)卡在下載CLIP或VAE模型首次運(yùn)行需下載依賴(lài)模型網(wǎng)絡(luò)不暢。1. 耐心等待或使用網(wǎng)絡(luò)工具。2. 可嘗試手動(dòng)下載相關(guān)文件并放入models/clip/等目錄需根據(jù)日志提示確定具體文件。訪問(wèn)http://127.0.0.1:8188無(wú)響應(yīng)1. 服務(wù)未成功啟動(dòng)。2. 端口被占用。1. 檢查終端是否有錯(cuò)誤日志。2. 嘗試更換端口啟動(dòng)如--port 8189。3. 檢查防火墻是否阻止了該端口。Checkpoint Loader中看不到模型1. 模型未放入正確目錄。2. 模型文件格式或結(jié)構(gòu)損壞。1. 確認(rèn)模型文件在models/checkpoints/目錄下。2. 確認(rèn)文件擴(kuò)展名正確.safetensors或.ckpt。3. 重啟ComfyUI以刷新列表。點(diǎn)擊生成后無(wú)反應(yīng)或報(bào)錯(cuò)OutOfMemory1. 顯存不足。2. 工作流過(guò)于復(fù)雜。1. 使用--lowvram參數(shù)啟動(dòng)。2. 嘗試生成更小尺寸的圖片如512x512。3. 關(guān)閉其他占用GPU的程序。整合包啟動(dòng)器閃退或報(bào)錯(cuò)1. 路徑包含中文或特殊字符。2. 被殺毒軟件攔截。3. 運(yùn)行庫(kù)缺失。1. 移動(dòng)整合包至純英文路徑。2. 關(guān)閉殺毒軟件實(shí)時(shí)防護(hù)并添加排除。3. 安裝 Visual C Redistributable 等系統(tǒng)運(yùn)行庫(kù)。安裝插件后界面錯(cuò)亂或報(bào)錯(cuò)1. 插件與當(dāng)前ComfyUI版本不兼容。2. 插件依賴(lài)未安裝。1. 禁用或卸載該插件。2. 查看插件README安裝其額外依賴(lài)。3. 更新ComfyUI和插件到最新版本。6. 生產(chǎn)環(huán)境與長(zhǎng)期維護(hù)建議如果你計(jì)劃長(zhǎng)期使用 ComfyUI 并用于半生產(chǎn)環(huán)境以下幾點(diǎn)建議能提升穩(wěn)定性和效率。環(huán)境隔離即使使用整合包也建議將其放在獨(dú)立的磁盤(pán)分區(qū)或文件夾中。避免與系統(tǒng)或其他Python項(xiàng)目混用便于備份和遷移。模型管理建立規(guī)范的模型目錄?？梢园搭?lèi)型、版本、作者進(jìn)行分類(lèi)存儲(chǔ)。利用extra_model_paths.yaml配置文件將模型庫(kù)集中管理而不是散落在各個(gè)整合包內(nèi)。工作流版本化將常用的、穩(wěn)定的工作流.json文件用 Git 或網(wǎng)盤(pán)進(jìn)行備份。記錄工作流對(duì)應(yīng)的模型版本和插件版本避免因更新導(dǎo)致工作流失效。定期更新ComfyUI 本體和插件迭代迅速。定期通過(guò)官方Git倉(cāng)庫(kù)或整合包啟動(dòng)器的更新功能進(jìn)行更新以獲取性能優(yōu)化和新功能。但注意更新前備份你的custom_nodes和workspace文件夾。日志監(jiān)控關(guān)注啟動(dòng)和運(yùn)行時(shí)的終端日志。錯(cuò)誤信息通常能直接指明問(wèn)題所在。對(duì)于復(fù)雜問(wèn)題可以嘗試用--verbose參數(shù)啟動(dòng)以獲得更詳細(xì)的日志。資源監(jiān)控在長(zhǎng)時(shí)間批量生成時(shí)監(jiān)控GPU溫度、顯存和系統(tǒng)內(nèi)存使用情況防止硬件過(guò)載。ComfyUI 的安裝只是探索其強(qiáng)大能力的第一步。它的學(xué)習(xí)曲線在于理解節(jié)點(diǎn)間數(shù)據(jù)流如LATENT,IMAGE,CONDITIONING的含義以及如何組合它們。建議從加載官方示例工作流開(kāi)始逐個(gè)節(jié)點(diǎn)理解其作用再?lài)L試修改參數(shù)和連接最終創(chuàng)造出符合自己需求的工作流。這個(gè)由節(jié)點(diǎn)構(gòu)成的畫(huà)布不僅是圖像生成的管道更是你理解和操控生成式AI模型內(nèi)部過(guò)程的窗口。