Windows下ComfyUI环境配置保姆级教程：从驱动检查到CUDA可用，手把手解决PyTorch和NumPy版本坑
Windows下ComfyUI环境配置全流程指南：从零开始搭建AI绘画工作站
最近在帮几位设计师朋友配置ComfyUI时，发现即便是技术基础薄弱的用户，只要按照正确的步骤操作，也能顺利完成环境搭建。本文将用最直观的方式，带你一步步完成从驱动检查到最终运行的完整流程。不同于网上零散的教程，这里我会把每个环节的底层逻辑和常见误区都解释清楚，就像面对面指导一样。
1. 准备工作：硬件与软件环境检查
在开始安装之前，我们需要确保基础环境符合要求。很多新手容易忽略这一步，直接跳到软件安装，结果后面遇到各种莫名其妙的报错。
1.1 显卡驱动检查与更新
首先确认你的显卡型号和驱动版本。按下Win+R，输入dxdiag并回车，切换到"显示"标签页：
- NVIDIA显卡用户：记录下"驱动程序版本"（如31.0.15.5186）
- AMD显卡用户：ComfyUI主要针对NVIDIA优化，AMD显卡可能无法使用CUDA加速
提示：如果驱动版本低于500，建议先更新驱动。可以到NVIDIA官网下载最新驱动，或者使用GeForce Experience自动更新。
1.2 确认CUDA兼容性
CUDA是NVIDIA提供的并行计算平台，ComfyUI依赖它来实现GPU加速。不同驱动版本支持的CUDA版本也不同：
| 驱动版本范围 | 最高支持的CUDA版本 |
|---|---|
| 450.00-520.00 | CUDA 11.x |
| 525.00及以上 | CUDA 12.x |
检查方法：
nvidia-smi输出顶部会显示CUDA版本信息。如果没有这个命令，需要先安装NVIDIA驱动。
1.3 Python环境准备
ComfyUI推荐使用Python 3.10-3.12版本。虽然它自带虚拟环境，但为了后续管理方便，建议先安装Python：
- 从Python官网下载3.12.x安装包
- 安装时勾选"Add Python to PATH"
- 安装完成后验证：
python --version2. ComfyUI基础安装
现在我们可以开始安装ComfyUI本体了。这里提供两种方式：直接下载和Git克隆。
2.1 下载与解压
- 从ComfyUI官方GitHub仓库下载最新版本
- 解压到一个没有中文和空格的路径（如
D:\AI\ComfyUI）
2.2 虚拟环境介绍
ComfyUI自带了一个虚拟环境（位于.venv文件夹），这可以避免与你系统中的其他Python项目产生冲突。后续所有操作都需要在这个虚拟环境中进行。
激活虚拟环境的方法：
cd D:\AI\ComfyUI\.venv\Scripts activate激活后，命令行提示符前会显示(.venv)。
3. PyTorch与CUDA配置
这是整个配置过程中最关键也最容易出问题的部分。我们将分步骤确保PyTorch能正确识别和使用CUDA。
3.1 卸载现有PyTorch（如有）
如果你之前安装过PyTorch，建议先卸载：
pip uninstall torch torchvision torchaudio -y3.2 安装匹配版本的PyTorch
根据你的CUDA版本选择对应的PyTorch安装命令。以下是常见组合：
CUDA 11.8：
pip install torch==2.2.0+cu118 torchvision==0.17.0+cu118 torchaudio==2.2.0+cu118 --index-url https://download.pytorch.org/whl/cu118CUDA 12.1：
pip install torch==2.2.0+cu121 torchvision==0.17.0+cu121 torchaudio==2.2.0+cu121 --index-url https://download.pytorch.org/whl/cu121
如果网络不稳定导致下载失败，可以手动下载whl文件后本地安装：
- 从PyTorch官网下载对应版本的whl文件
- 使用pip安装本地文件：
pip install D:\Downloads\torch-2.2.0+cu118-cp312-cp312-win_amd64.whl3.3 验证PyTorch CUDA支持
安装完成后，验证CUDA是否可用：
python -c "import torch; print(torch.cuda.is_available())"如果输出True，说明配置成功；如果为False，请检查前面的步骤。
4. 解决依赖问题
除了PyTorch，ComfyUI还需要其他一些Python包，其中NumPy是最容易出问题的。
4.1 NumPy版本选择
Python 3.12用户需要特别注意，必须使用NumPy 1.26.x及以上版本：
pip install numpy==1.26.44.2 其他依赖安装
ComfyUI的requirements.txt中列出了所有依赖项。安装方法：
pip install -r requirements.txt如果遇到编译错误，可以尝试：
pip install --pre --upgrade -r requirements.txt5. 最终验证与运行
完成所有安装后，我们需要进行全面的环境检查。
5.1 环境完整性检查
运行以下命令检查关键组件版本：
python -c "import torch, numpy; print(f'PyTorch: {torch.__version__}, CUDA: {torch.cuda.is_available()}'); print(f'NumPy: {numpy.__version__}')"5.2 启动ComfyUI
回到ComfyUI根目录，根据你的显卡类型选择启动方式：
- NVIDIA显卡：双击
run_nvidia_gpu.bat - 其他显卡：双击
run_cpu.bat
首次启动会下载一些模型文件，可能需要较长时间。启动成功后，在浏览器中打开http://127.0.0.1:8188即可使用。
6. 常见问题解决方案
即使按照步骤操作，仍可能遇到一些问题。以下是几个典型场景的解决方法：
6.1 模型加载失败
如果ComfyUI无法加载模型，检查：
- 模型文件是否放在正确的文件夹（通常是
ComfyUI\models\checkpoints） - 模型文件是否完整（可以重新下载）
6.2 显存不足
生成高分辨率图像时可能出现显存不足。可以尝试：
- 降低图像分辨率
- 使用
--lowvram参数启动 - 关闭其他占用显存的程序
6.3 插件安装问题
安装第三方插件时，确保：
- 插件与当前ComfyUI版本兼容
- 插件依赖已正确安装
- 插件文件放在
ComfyUI\custom_nodes文件夹
配置过程中遇到任何问题，都可以查看ComfyUI的日志文件（通常位于根目录的comfyui.log），里面通常会有详细的错误信息。