ComfyUI Windows 环境排错实录
在 Windows 上部署 ComfyUI,很多人都会遇到这种尴尬局面:Python 装好了,CUDA 驱动也正常,显卡也能被系统识别,但启动器就是跑不起来,或者命令行和图形界面表现不一致。
这往往不是单一操作失误,而是 Python 版本、CUDA 构建与虚拟环境配置叠加后的结果。我们这次遇到的情况比较典型:
- Python 多版本共存导致的环境错位
- CUDA / PyTorch 无法正确识别 GPU
- 启动器与命令行运行环境不一致
下面我结合实际排查过程,把这三个高频问题的根因和解决方案梳理一遍。
问题一:Python 版本混乱(3.10 / 3.11 / 3.14 冲突)
在所有问题中,Python 版本混乱是第一个、也是最致命的根因。后续出现的 PyTorch 异常、插件安装失败,本质上都可以追溯到这一点。
现象表现
最让人迷惑的不是报错本身,而是'每个地方看到的 Python 版本都不一样':
- 在 PowerShell / CMD 中执行
python -V,显示的是 Python 3.14 - 进入 ComfyUI 自带的
venv后,python -V却是 Python 3.10 - 启动器的环境检测中,显示的 Python 与命令行结果不一致
- PyTorch 安装成功,但运行时却出现模块找不到、CUDA 不可用等问题
这些现象单独看都不算致命错误,但组合在一起,就会让人产生一种错觉:'明明都装好了,为什么就是跑不起来?'
核心原因
问题的根本并不复杂,但非常典型——Windows 下多 Python 共存 + 默认 PATH 机制。
具体来说,核心原因有三点:
- Windows 的 PATH 中存在多个 Python
- 系统 Python(可能是 3.14)
- 其他软件自带的 Python
- ComfyUI 实际需要使用的 Python 3.10
- 启动器默认调用的是'系统 Python'
- 启动器并不会自动识别 venv
- 如果不手动指定,它只会从 PATH 中找第一个
python.exe
- ComfyUI 对 Python 版本是'有要求的'
- 当前稳定版本的 ComfyUI + PyTorch 生态,明确推荐 Python 3.10
- 使用 3.11 / 3.14 虽然可能安装成功,但极易在运行期出问题
这就造成了一个典型错位:你以为你在用 venv 的 Python 3.10,但启动器实际上还在调用系统里的 Python 3.14。
解决方案
解决思路只有一个:彻底让'运行 Python'与'预期 Python'对齐。
具体操作步骤如下:
- 单独安装 Python 3.10
- 不要覆盖系统 Python
- 指定一个清晰、固定的安装目录
- 使用 venv 进行环境隔离
- 所有依赖(PyTorch、ComfyUI 插件)只安装在 venv 内
- 不再向系统 Python 安装任何依赖
- 在启动器中手动指定 Python 路径(关键步骤)
将启动器中的 Python 路径明确设置为:
E:\Aicg\Comfyui\ComfyUI-aki-v3\venv\Scripts\python.exe


