ComfyUI ModuleNotFoundError: No module named 'torch' 修复

当启动 ComfyUI 的 Python 无法导入 Torch 时，ComfyUI 会因为 ModuleNotFoundError: No module named 'torch' 停止运行；用户也常搜索 No module named torch 或 ComfyUI torch missing。这是核心运行时故障，不是可以忽略的警告。

正确修法是：把 CUDA 版 Torch 安装到“真正启动 ComfyUI 的那个 Python”里，然后确认它不是 CPU-only 构建。

.\python_embeded\python.exe -s -m pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cuXXX

把 cuXXX 替换成 PyTorch 官方安装选择器里与你的环境匹配的 CUDA wheel 标签。重启前确认 torch.version.cuda 不是 None，并且 torch.cuda.is_available() 返回 True。

快速判断

第 1 步：确认 ComfyUI 实际使用哪个 Python

Windows 便携版：

.\python_embeded\python.exe -s -c "import sys; print(sys.executable)"
.\python_embeded\python.exe -s -m pip show torch torchvision torchaudio

手动 venv：

.\venv\Scripts\activate
python -c "import sys; print(sys.executable)"
python -m pip show torch torchvision torchaudio

如果你用的是 ComfyUI Desktop 或其他托管启动器，请使用应用自己的终端或环境工具，不要默认它一定有 python_embeded。

第 2 步：在当前环境安装 Torch

根据你的 GPU、驱动、Python 版本和 PyTorch 支持矩阵，在 PyTorch 官方安装选择器里选 CUDA wheel。不要从裸 pip install torch 开始；它可能只把导入修回来，但装成 CPU-only。

Windows 便携版请通过嵌入式 Python 运行所选命令：

.\python_embeded\python.exe -s -m pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cuXXX

手动 venv 先激活环境，再用同样的 --index-url 模式执行 python -m pip。记得把 cuXXX 换成你支持的 CUDA wheel 标签。

第 3 步：确认没有装成 CPU Torch

在启动 ComfyUI 的同一个 Python 中运行：

.\python_embeded\python.exe -s -c "import torch; print(torch.__version__, torch.version.cuda, torch.cuda.is_available()); print(torch.cuda.get_device_name(0) if torch.cuda.is_available() else 'no cuda')"

如果输出版本以 +cpu 结尾，并且显示 None False，就是 CPU-only 构建。回到第 2 步，用 CUDA wheel 命令重新安装。不要把区域镜像混进主命令；网络访问和包来源可信度要分开处理。

如果 Torch 能导入但 CUDA 仍失败，继续看 ComfyUI 中 Torch Not Compiled With CUDA Enabled。

第 4 步：重启并读取下一个首要错误

.\python_embeded\python.exe -s ComfyUI\main.py --windows-standalone-build

受损的便携版环境里，下一个阻断点经常是另一个核心包，比如 safetensors、packaging、numpy、torchvision 或 torchaudio。继续在同一个 Python 中修“下一条首要错误”，不要切到随机包命令。如果环境一直从一个核心包坏到另一个核心包，请使用 逐包修复 ComfyUI 便携版依赖。

不要这样做

• ComfyUI 从 python_embeded 或 venv 启动时，不要把 Torch 装进系统 Python
• 不要把 import torch 成功等同于 CUDA 已修复
• 普通 wheel 版 ComfyUI 环境不要先重装 CUDA Toolkit
• 还没搞清楚第一个阻断点前，不要从 pip install -r 开始
• 核心运行时没恢复前，不要重装自定义节点

相关指南

• ComfyUI 中 Torch Not Compiled With CUDA Enabled
• 逐包修复 ComfyUI 便携版依赖
• ComfyUI 中未安装 comfyui-frontend-package
• ComfyUI 依赖冲突
• 安装自定义节点后 ComfyUI 出问题？无需重装即可恢复

来源参考

• PyTorch 本地安装选择器