Windows 下 ComfyUI 环境搭建实战及常见错误解决

Windows 下 ComfyUI 环境搭建实战及常见错误解决

一、环境搭建详细步骤

1. 系统要求检查

• 操作系统: Windows 10/11 (64位)
• 显卡: NVIDIA GPU (推荐8GB+显存)，也支持AMD GPU和CPU模式
• 内存: 16GB+ RAM
• 存储空间: 20GB+ 可用空间

2. 安装必需软件

步骤1: 安装Python 3.10.x

# 推荐使用Python 3.10.6-3.10.11之间的版本# 官网下载: https://www.python.org/downloads/# 安装时务必勾选"Add Python to PATH"

步骤2: 安装Git

# 下载地址: https://git-scm.com/download/win# 安装后验证git--version

步骤3: 安装CUDA和cuDNN (仅限NVIDIA GPU用户)

# 查看CUDA兼容性: nvidia-smi# CUDA Toolkit下载: https://developer.nvidia.com/cuda-toolkit-archive# 推荐CUDA 11.8或12.1

3. ComfyUI安装步骤

方法A: 使用官方仓库 (推荐)

# 1. 克隆仓库gitclone https://github.com/comfyanonymous/ComfyUI.gitcdComfyUI# 2. 创建虚拟环境 (推荐)python -m venv venv .\venv\Scripts\activate# 3. 安装依赖pipinstalltorch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118# 或使用CPU版本: pip install torch torchvision torchaudio# 4. 安装其他依赖pipinstall-r requirements.txt

方法B: 使用便携版/一键安装

# 对于新手，推荐使用便携版本# 1. 下载便携版: https://github.com/comfyanonymous/ComfyUI/releases# 2. 解压到任意目录# 3. 运行 run_nvidia_gpu.bat (NVIDIA GPU)# 或 run_cpu.bat (CPU模式)

4. 模型文件准备

ComfyUI/ ├── models/ │ ├── checkpoints/ # 放置大模型 (.safetensors, .ckpt) │ ├── vae/ # VAE模型 │ ├── loras/ # LoRA模型 │ ├── controlnet/ # ControlNet模型 │ └── upscale_models/ # 超分模型

常用模型下载位置:

• Hugging Face: https://huggingface.co/
• CivitAI: https://civitai.com/

5. 运行ComfyUI

# 基本启动python main.py# 常用参数python main.py --listen# 允许网络访问python main.py --port8188# 指定端口python main.py --highvram# 高显存模式python main.py --lowvram# 低显存模式python main.py --cpu# CPU模式# 指定模型路径python main.py --extra-model-paths-config extra_model_paths.yaml

二、常见错误及解决方案

错误1: “Torch not compiled with CUDA enabled”

# 解决方案1. 卸载现有torch pip uninstall torch torchvision torchaudio2. 重新安装对应CUDA版本的torch# CUDA 11.8pipinstalltorch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118# CUDA 12.1pipinstalltorch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu1213. 验证安装 python -c"import torch; print(torch.cuda.is_available())"

错误2: 内存不足 (Out of Memory)

# 解决方案1. 使用低显存模式启动 python main.py --lowvram2. 添加虚拟内存# 系统设置 → 高级系统设置 → 性能设置 → 高级 → 虚拟内存 → 更改3. 使用--cpu-only部分节点# 在extra_model_paths.yaml中配置memory_attention_slice:true4. 清理浏览器缓存# ComfyUI会缓存图像到浏览器

错误3: 模块导入错误

# 错误信息示例ModuleNotFoundError:No module named'xformers'# 解决方案# 安装缺失模块pip install xformers# 如果安装失败，使用预编译版本pip install xformers--index-url https://download.pytorch.org/whl/cu118# 或者使用替代方案pip install xformers-0.0.22.post4+cu118torch2.1.2-cp310-cp310-win_amd64.whl

错误4: 模型加载失败

# 解决方案1. 检查模型格式# 推荐使用.safetensors格式，更安全2. 检查模型位置# 确保模型放在正确的目录下3. 检查模型完整性# 重新下载损坏的模型4. 检查模型兼容性# 有些模型需要特定的VAE或配置

错误5: WebUI无法访问

# 解决方案1. 检查防火墙设置# 允许Python通过防火墙2. 检查端口占用netstat-ano|findstr :8188 taskkill /PID[PID]/F3. 使用--listen参数 python main.py --listen0.0.0.0 --port81884. 检查浏览器缓存# 清除浏览器缓存或使用无痕模式

错误6: 节点加载失败

# 解决方案1. 更新ComfyUIgitpull pipinstall-r requirements.txt2. 清理自定义节点# 临时移除custom_nodes文件夹内容3. 检查节点兼容性# 有些节点需要特定版本的依赖4. 查看详细错误日志# 查看控制台输出或logs文件夹

错误7: Python路径问题

# 解决方案1. 确认Python版本 python --version2. 使用完整路径# 在.bat文件中使用完整Python路径"C:\Users\用户名\ComfyUI\venv\Scripts\python.exe"main.py3. 修复环境变量setPATH=C:\Users\用户名\AppData\Local\Programs\Python\Python310;C:\Users\用户名\AppData\Local\Programs\Python\Python310\Scripts;%PATH%

三、优化配置

1. 创建启动脚本 (start_comfyui.bat)

@echo off cd /d "C:\ComfyUI" call venv\Scripts\activate.bat python main.py --listen --port 8188 --auto-launch pause

2. 配置extra_model_paths.yaml

# 创建于ComfyUI根目录a111:base_path:"D:/StableDiffusion/models"checkpoints:"D:/StableDiffusion/models/Stable-diffusion"vae:"D:/StableDiffusion/models/VAE"loras:"D:/StableDiffusion/models/Lora"upscale_models:"D:/StableDiffusion/models/ESRGAN"

3. 性能优化设置

# 修改comfyui/web.py中的默认设置"app":{"max_upload_size":100,# MB"max_image_pixels":4096*4096}# 使用--disable-smart-memory参数python main.py --disable-smart-memory

四、故障排除流程

1. 检查基础环境

   • Python版本是否正确
   • 虚拟环境是否激活
   • CUDA是否可用

2. 查看错误日志

   # 控制台错误信息# logs文件夹中的日志# 浏览器开发者工具(F12)中的错误

3. 简化测试

   # 1. 使用纯净环境# 2. 只加载基础模型# 3. 使用默认工作流

4. 逐步排查

   • 从官方仓库重新克隆
   • 使用requirements.txt精确版本
   • 逐个添加自定义节点

五、实用工具和资源

1. 管理器工具

   • ComfyUI Manager: https://github.com/ltdrdata/ComfyUI-Manager

2. 常用自定义节点

   • ComfyUI-Impact-Pack: 增强功能包
   • WAS Node Suite: 工具集
   • Efficiency Nodes: 性能优化

3. 监控工具

   # GPU监控nvidia-smi -l1# 内存监控taskmgr# 任务管理器

4. 备份策略

   # 备份工作流# 备份custom_nodes配置# 定期备份模型文件

六、快速修复命令集合

# 1. 重置环境rmdir/s venv python -m venv venv .\venv\Scripts\activate pipinstall-r requirements.txt# 2. 清理缓存python -c"from comfy.cli_args import args; import shutil; shutil.rmtree('temp')"# 3. 更新所有依赖pip list --outdated pipinstall--upgrade -r requirements.txt# 4. 修复权限问题icacls./grant Users:(OI)(CI)F /T

通过以上步骤，应该能够成功搭建ComfyUI环境并解决大部分常见问题。如遇特殊问题，建议查看ComfyUI官方GitHub的Issues页面获取最新解决方案。