知仓学习社知仓学习社
AssertionError: Torch not compiled with CUDA enabled（装了 CPU 版 torch，或装到了系统 Python） / 全站资源搜索
搜索 更新 2026-10-02
报错 096 硬件、驱动、操作系统与非 N 卡环境 有来源可查

AssertionError: Torch not compiled with CUDA enabled（装了 CPU 版 torch，或装到了系统 Python）

报错原文（原样） 
AssertionError: Torch not compiled with CUDA enabled
检索关键词 Torch not compiled with CUDA enabled、pip uninstall torch、torch.cuda.is_available()、python_embeded、cu130、+cu128
先看这一句 ComfyUI 启动或执行时报 AssertionError: Torch not compiled with CUDA enabled；同时启动日志里 CUDA 设备数为 0，或者干脆 Device: cpu。
适用版本 全版本通用。AMD 显卡用户如果看到这条错误，说明装成了 CUDA 版 torch，应改按 ROCm（Linux）或 XPU/DirectML 的方式安装（见 Intel/AMD 条目）。 · 核实日期 2026-09-26 · 状态 已核实
适用环境：Windows 便携版、秋叶/绘世整合包、ComfyUI Desktop、Linux + 云 GPU、全部主流环境

现象与触发场景

常见触发场景：

  • 用 pip install torch 装到了 CPU 版 wheel（默认索引在 Windows 上就是 CPU 版）
  • 在系统 Python 里装了 CUDA 版 torch，但 ComfyUI 用的是自己的 python_embeded
  • 重装/更新插件时某个依赖把 torch 覆盖成了 CPU 版

根因

  • PyPI 上 torch 的默认 wheel 是 CPU 构建，只有带 +cuXXX 后缀的才是 CUDA 构建；CUDA 构建要从 download.pytorch.org 的对应索引安装。
  • 官方文档明确指出：这个错误说明 PyTorch 安装时没有 CUDA 支持，解法是卸载后按对应索引重装，并且要在 ComfyUI 使用的那个 Python 环境里操作。
  • ComfyUI Desktop 版尤其容易踩坑：用户装了系统 Python 的 torch，而 Desktop 用的是它自己打包的 Python。

解决步骤

已按「最可能有效」排序。请从上往下做，每做完一步用「验证」确认，不要一次改五处。

  1. 卸载 torch 并按官方索引重装 CUDA 版
    官方排障文档给出的步骤是先 pip uninstall torch，再用 cu130 索引重装 torch/torchvision/torchaudio。50 系卡不能用 cu126 及更低。
    python -m pip uninstall -y torch torchvision torchaudio
    python -m pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130
    python -m pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu128
  2. 确保装进的是 ComfyUI 自己的 Python 环境
    用 ComfyUI 内置解释器执行 pip，并在安装后立刻用它验证版本号里带 +cuXXX 后缀。woct0rdho 在 5060ti 的 issue 里反复强调：必须先确认用户是怎么运行命令的、输出是什么，并且要安装在 python_embeded 里。
    python_embeded\python.exe -m pip list
    python_embeded\python.exe -c "import torch,sys; print(sys.executable, torch.__version__, torch.version.cuda, torch.cuda.is_available())"
  3. 重装后重新验证，并检查是否被别的包降级
    装完自定义节点或依赖后要再次确认 torch 版本没被覆盖成 CPU 版。Desktop 版可在底部面板 / 设置里的终端执行同一条 pip 命令。
    python -c "import torch; print(torch.__version__, torch.version.cuda, torch.cuda.is_available())"

验证是否修好

torch.cuda.is_available() 返回 True，torch.__version__ 带 +cu128/+cu130 后缀，ComfyUI 启动日志的 Device 行为 cuda:0。

补充说明

报错原文逐字取自 ComfyUI 官方排障文档与 Comfy-Org/ComfyUI issue #7826 标题。issue #7826 中维护者 woct0rdho 的两点结论值得记住：不需要单独安装几 GB 的 CUDA Toolkit（torch wheel 自带所需 CUDA 库）；nvidia-smi 里的 CUDA 版本是驱动支持的最高版本，只要它不低于 torch 的 CUDA 版本即可。

来源

按可信度排列：官方 issue / 官方文档 > 节点仓库 issue > 社区帖 > 中文社区文章。 链接以纯文本给出（本站不做站外跳转），需要核对时请自行复制到浏览器打开。
  1. [6] （官方文档）　How to Troubleshoot and Solve ComfyUI Issues　https://docs.comfy.org/troubleshooting/overview
  2. [137] （官方 issue）　AssertionError: Torch not compiled with CUDA enabled on 5060ti · Issue　https://github.com/Comfy-Org/ComfyUI/issues/7826
  3. [136] （官方文档）　Common Issues and Solutions - ComfyUI　https://mintlify.wiki/Comfy-Org/ComfyUI/guides/common-issues
  4. [219] （官方文档）　Hardware Support - ComfyUI　https://mintlify.wiki/Comfy-Org/ComfyUI/configuration/hardware-support

这条报错要用到的东西

按本条报错所属的类别（硬件、驱动、操作系统与非 N 卡环境）列出站内相关的下载包与板块入口。 它们不是「必须下载才能修好」，而是这一类问题里最常要动到的东西；具体怎么做，以上面的解决步骤为准。

环境与依赖配置包依赖版本组合清单 / 环境自检脚本说明 待挂载

同一类别的其他条目

【089】50 系显卡（RTX 5060 Ti / 5070 / 5080 / 5090）驱动版本太旧，ComfyUI 启动或生成直接失败 含未核实 【090】RTX 50 系 / 新卡报 CUDA error: no kernel image is available for execution on the device（跑到了没有 sm_120 kernel 的 torch 上） 有来源 【091】Blackwell 显卡生成在第一个注意力层失败：cuDNN Frontend error: No valid execution plans built 含未核实 【092】在 cmd 里敲 nvidia-smi 提示“不是内部或外部命令”：驱动装的是 DCH/未装 NVIDIA 驱动或 PATH 里没有 System32 有来源 【093】ComfyUI Desktop 报 “ComfyUI requires an NVIDIA GPU on Windows. No NVIDIA GPU was detected” 卡在启动页（含被迫用 --cpu 的慢速兜底） 有来源
这个解法对你有效吗 记录只存在你自己的浏览器里，不需要注册账号。

返回报错库