前言
在 Windows 平台部署 ComfyUI 时，很多用户都会遇到类似问题：Python 已安装、CUDA 驱动正常、显卡也能识别，但 ComfyUI 仍然无法正常启动，或在启动器与命令行之间反复报错。
这些问题往往并非某一步操作失误，而是 Python 版本不一致、CUDA 与 PyTorch 构建不匹配，以及启动器未正确使用虚拟环境等因素叠加造成的结果。
本文将围绕 ComfyUI + 启动器的典型使用场景，系统梳理以下三个高频问题：
- Python 多版本共存导致的环境错位
- CUDA / PyTorch 无法正确识别 GPU
- 启动器与命令行运行环境不一致
并给出可复现、可验证、适合新手操作的解决方案，帮助你在 Windows 环境下，先把 ComfyUI 的基础运行环境彻底跑稳。
本文聚焦基础 python 环境配置问题，插件与扩展相关内容将放在后续文章中单独说明。
本次实际使用的组合是：
- ComfyUI 便携包
- NVIDIA 显卡环境（CUDA）
- PyTorch（CUDA 版本）
- GitHub 插件体系
这些组件单独使用时问题不大，但一旦组合在一起，就会出现一个典型问题：每一个工具都假设'系统环境是干净且唯一的'，而现实恰恰相反。
例如：
- Python 工具默认认为：系统里只有一个 Python
- 启动器默认认为：系统 Python 就是运行 Python
- PyTorch 默认认为：安装它的 Python 就是运行它的 Python
- GitHub 插件默认认为：网络环境稳定、GitHub 可直连
这些'合理但不现实'的默认假设，在同一台 Windows 机器上叠加后，最终导致了一系列看似无关、实则强相关的问题集中爆发，包括：
- Python 版本混乱
- CUDA / PyTorch 无法识别
- 启动器与命令行行为不一致
- 插件安装过程中 GitHub 克隆反复失败
因此，本次环境'全面崩溃'的核心原因并不是操作失误，而是：
多个工具在同一环境中叠加运行，而它们都默认用户的系统是'干净的'。
理解这一点，是后续所有问题能够被逐一拆解和解决的前提。
二、问题一：Python 版本混乱（3.10 / 3.11 / 3.14 冲突）
在所有问题中，Python 版本混乱是第一个、也是最致命的根因。后续出现的 PyTorch、CUDA、插件安装异常，本质上都可以追溯到这一点。
2.1 现象表现
在实际排查过程中，最让人迷惑的不是报错本身，而是'每个地方看到的 Python 版本都不一样'：
- 在 PowerShell / CMD 中执行
python -V，显示的是 Python 3.14 - 进入 ComfyUI 自带的
venv后，python -V却是 Python 3.10 - 启动器的环境检测中，显示的 Python 与命令行结果不一致
- PyTorch 安装成功，但运行时却出现：
- 模块找不到
- CUDA 不可用
- 运行路径与安装路径不一致
这些现象单独看都不算'致命错误'，但组合在一起，就会让人产生一种错觉： '明明都装好了，为什么就是跑不起来？'
2.2 核心原因
问题的根本并不复杂，但非常典型——Windows 下多 Python 共存 + 默认 PATH 机制。
具体来说，核心原因有三点：
- Windows 的 PATH 中存在多个 Python
- 系统 Python（可能是 3.14）
- 其他软件自带的 Python
- ComfyUI 实际需要使用的 Python 3.10
