Windows装ComfyUI出错怎么办

在 Windows 上安装/运行 ComfyUI 出错很常见，通常和 Python 环境、显卡驱动、依赖包、路径问题 有关。你可以按下面步骤逐一排查，基本能解决 90% 的问题。

一、先确认最基础的环境

1️⃣ 显卡 & 驱动（最重要）

ComfyUI 主要靠 NVIDIA 显卡 + CUDA

• 有 NVIDIA 显卡：
• 更新驱动：https://www.nvidia.com/Download/index.aspx
• 确认支持 CUDA（10 系及以上基本都行）
• 只有核显 / AMD：
• 只能用 CPU 或 DirectML（慢，不推荐）

✅ 检查命令：

nvidia-smi

能看到显卡和驱动版本就正常。

2️⃣ Python 版本（非常关键）

ComfyUI 推荐 Python 3.10 或 3.11
❌ 不推荐：

• Python 3.12（很多依赖不兼容）
• Microsoft Store 版 Python（容易出权限问题）

✅ 建议：

• 官网下载：https://www.python.org/downloads/
• 安装时勾选 Add Python to PATH

二、最常见的安装错误 & 解决办法

❌ 错误 1：torch not compatible / CUDA not available

通常是 PyTorch 装错版本
✅ 正确安装方式（NVIDIA）：

pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu121

（cu121 对应 CUDA 12.1，常见）

❌ 错误 2：Microsoft Visual C++ 14.x required

缺编译环境
✅ 解决：
安装 Visual Studio Build Tools

• 勾选：使用 C++ 的桌面开发
• 下载：https://visualstudio.microsoft.com/visual-cpp-build-tools/

❌ 错误 3：路径有中文 / 空格

ComfyUI 非常怕中文路径
❌ 错误示例：

C:\用户\小明\桌面\ComfyUI

✅ 正确示例：

D:\ComfyUI

❌ 错误 4：No module named 'x'

依赖没装全
✅ 解决：
在 ComfyUI 目录执行：

pip install -r requirements.txt

❌ 错误 5：双击 main.py 没反应

必须用命令行运行
✅ 正确方式：

cd D:\ComfyUI
python main.py

三、不想折腾？直接用“懒人包”

如果你只是想用，不想配环境：

✅ 推荐方案

• ComfyUI 官方 Windows 包（带 CUDA）
• 或第三方整合包（如 B 站常见的一键启动）

优点：

• 不用装 Python
• 双击就能用

四、你把错误贴出来，我可以直接帮你定位

你可以把下面任意一个发给我：

• ❌ 红字报错截图
• ❌ 命令行完整报错
• ❌ 你用的安装方式（官方 / 整合包 / 手动）

我可以直接告诉你 是哪一步错了、怎么改。