ComfyUI 启动报 ModuleNotFoundError torch 缺失，通常是因为当前 Python 环境未安装 PyTorch 或依赖文件未完整加载。最推荐的处理方向是检查 ComfyUI 调用的 Python 路径，并在该环境中重新安装 torch 依赖，注意区分 CPU 版本与 CUDA 版本。
先说结论：确认 Python 环境后重装依赖即可解决，无需重装系统或更换软件版本。
- 先确认 ComfyUI 使用的 Python 路径
- 先处理 torch 安装匹配问题
- 再验证模块导入是否正常
命令速用版
在 ComfyUI 根目录或对应 Python 环境中执行以下命令，根据硬件选择其一。
pip install -r requirements.txt
CUDA 12.1 环境：pip install torch torchvision torchaudio `--index-url` https://download.pytorch.org/whl/cu121
CPU 环境：pip install torch torchvision torchaudio `--index-url` https://download.pytorch.org/whl/cpu
为什么会这样
Python 依赖未正确安装或环境隔离导致模块找不到。ComfyUI 依赖 PyTorch 进行深度学习推理，若当前运行的 Python 解释器缺少 torch 库，启动时导入模块会失败。常见于使用系统 Python 运行便携版 ComfyUI，或虚拟环境未激活。
分步处理
第一步：确认 Python 路径。检查启动脚本调用的 python.exe 位置，便携版通常内置在 ComfyUI 文件夹内。
第二步：安装依赖。进入 ComfyUI 根目录，使用对应 Python 的 pip 工具安装 requirements.txt。
第三步：手动安装 torch。若 requirements 安装失败，使用 PyTorch 官方命令单独安装 torch 库。
第四步：检查网络。国内网络可能无法连接 pypi 源，需配置镜像源或离线安装。
怎么验证是否生效
在命令行执行python -c "import torch; print(torch.__version__)"，无报错且输出版本号即表示环境正常。重新启动 ComfyUI，观察控制台是否不再出现 ModuleNotFoundError。
常见坑
多版本 Python 冲突。系统存在多个 Python 时，pip 可能安装到了错误的环境。使用绝对路径调用 pip，例如C:\Python310\python.exe -m pip install ...。
CUDA 版本不匹配。安装的 torch 版本与显卡驱动支持的 CUDA 版本不一致会导致运行时错误，需核对显卡驱动版本。
常见问题
没有显卡可以运行吗
可以，但需要安装 CPU 版本的 torch。生成速度会显著慢于 GPU 环境，仅适合测试流程。
使用 Conda 环境需要注意什么
需要先激活 Conda 环境再执行安装命令。确保 ComfyUI 启动脚本指向 Conda 环境中的 Python 解释器。
离线环境如何安装
需在有网络机器下载 whl 文件后拷贝至离线机器。使用pip install 文件名.whl进行本地安装。
参考来源
ComfyUI GitHub Repository: https://github.com/comfyanonymous/ComfyUI
PyTorch Official Website: https://pytorch.org/get-started/locally/