Windows上ComfyUI安装常见问题

Windows安装ComfyUI常见问题及解决方法

1. 依赖安装失败（如Python、VS Build Tools缺失）

ComfyUI需要Python 3.7+、VS Build Tools（提供C++编译工具）等基础依赖。若安装时提示“缺少xxx组件”，需手动补充：

• Python：前往Python官网下载最新版本，安装时务必勾选“Add Python to PATH”；
• VS Build Tools：从微软官网下载安装，勾选“C++ build tools”“Windows 10 SDK”等组件；
• Git：用于克隆仓库，从Git官网下载安装并添加至PATH。

2. CUDA报错（显卡驱动或版本不匹配）

NVIDIA显卡用户需确保：

• 显卡驱动更新：前往NVIDIA官网下载最新驱动，支持CUDA 11.8+；
• PyTorch与CUDA版本匹配：安装时选择对应CUDA版本的PyTorch（如pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118），避免版本冲突。

3. 路径含中文导致兼容性问题

ComfyUI对中文路径支持不佳，需确保：

• 安装目录（如解压路径、模型目录）无中文字符；
• 启动脚本（如run_nvidia_gpu.bat）所在目录为纯英文。

4. 模型加载失败（路径或格式错误）

• 模型路径：需将Stable Diffusion模型（.ckpt/.safetensors）放入ComfyUI\models\checkpoints目录；
• 模型格式：仅支持.ckpt或.safetensors格式，下载时需确认文件完整性；
• 共享模型：若复用AUTOMATIC1111的模型库，需修改extra_model_paths.yaml（重命名示例文件并修改base_path）。

5. 端口冲突（默认8188端口被占用）

若启动时报“端口已被占用”，可通过修改启动参数更换端口：

• 命令行运行：python main.py --port 1234（将1234替换为可用端口）；
• 或编辑bat脚本（如run_nvidia_gpu.bat），在启动命令后添加--port 1234。

6. 启动失败（黑屏或闪退）

• 残留文件清理：若之前安装失败，需手动删除resources、chrome_*.pak、comfyui.exe等残余文件；
• 使用便携版：下载官方便携包（如ComfyUI_windows_portable_nvidia.7z），解压后直接运行bat脚本，避免安装残留；
• 查看错误日志：通过命令提示符运行启动脚本，根据错误信息进一步排查（如缺少依赖、路径错误）。

7. 插件安装问题（无法加载或冲突）

• 插件目录：将插件克隆到ComfyUI\custom_nodes文件夹（如git clone https://github.com/.../ComfyUI-xxx.git）；
• 重启生效：安装后需重启ComfyUI，否则插件无法加载；
• 版本兼容：确保插件版本与ComfyUI版本匹配（如插件要求ComfyUI≥0.4.0，则需升级ComfyUI）。

8. 性能缓慢（CPU/GPU利用率低）

• GPU加速：优先使用NVIDIA显卡（推荐RTX 30系列以上），确保CUDA加速开启；
• 清理缓存：定期运行pip cache purge清理pip缓存，删除ComfyUI\temp文件夹释放磁盘空间；
• 模型选择：使用轻量级模型（如Stable Diffusion XL 1.0），减少内存占用。