启动或首次生成时报 AssertionError: Torch not compiled with CUDA enabled（装成了 CPU 版 torch）

File "...\torch\cuda\__init__.py", line 310, in _lazy_init
raise AssertionError("Torch not compiled with CUDA enabled")
AssertionError: Torch not compiled with CUDA enabled

现象与触发场景

常见触发场景：

• 用普通 pip install torch 装过依赖，PyPI 在 Windows 上默认给的是 CPU 版 wheel
• 装完某个自定义节点后，节点的 requirements.txt 里写了 torch>=2.x，pip 把原来的 CUDA 版 torch 覆盖成 CPU 版
• 跑过一次 pip install -r requirements.txt 或 ComfyUI-Manager 的“安装依赖”之后突然变 CPU

根因

• PyTorch 的 CPU wheel 与 CUDA wheel 是两个完全不同的二进制，CPU wheel 里没有任何 GPU kernel，装驱动、装 CUDA Toolkit、设环境变量都无法让它支持 CUDA，只能换 wheel。
• 在 Windows 上 PyPI 默认提供的是 CPU-only 的 torch；CUDA 版只存在于 PyTorch 官方索引（download.pytorch.org/whl/cuXXX），所以任何不带 --index-url 的 pip install torch 都会把 CUDA 版挤掉。
• 官方 README 已明确指出：遇到该错误的处理办法就是卸载 torch 并从 CUDA 索引重装。

解决步骤

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

1. 先用便携版自带解释器确认是不是 CPU wheel
   便携版有自己的 Python，在 ComfyUI_windows_portable 目录下必须显式调用 python_embeded\python.exe，否则你测的是系统 Python，看到的结果和 ComfyUI 实际用的环境无关。输出的版本号结尾若是 +cpu 或 cuda.is_available() 为 False，就确认是 CPU wheel。
   .\python_embeded\python.exe -c "import torch; print(torch.__version__); print(torch.version.cuda); print(torch.cuda.is_available()); print(torch.cuda.get_device_name(0))"
2. 卸载 CPU 版 torch 三件套，从 PyTorch 官方索引重装 cu128
   先卸载再安装，避免 pip 认为“已满足依赖”而保留 CPU 版。50 系显卡要装 cu128（或更高）而非 cu124/cu126，并且要用 --index-url 而不是 --extra-index-url，这样 pip 只从 PyTorch 索引取包，不会回退到 PyPI 的 CPU 版。
   .\python_embeded\python.exe -m pip uninstall -y torch torchvision torchaudio
   .\python_embeded\python.exe -m pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu128
3. 给 ComfyUI-Manager 加防覆盖配置，避免自定义节点再次把 torch 换回 CPU 版
   在 ComfyUI-Manager 的 config.ini 中把 torch 三件套加入 downgrade_blacklist，Manager 就不会在装节点依赖时降级/替换它们；pip_auto_fix.list 可以用来在启动时自动恢复指定版本的包。config.ini 在 v0.3.76+ 位于 <USER_DIRECTORY>/__manager/，老版本位于 <USER_DIRECTORY>/default/ComfyUI-Manager/。
   downgrade_blacklist = torch, torchvision, torchaudio

验证是否修好

补充说明

若显示 +cu128 且 is_available() 为 True 但 ComfyUI 仍报同样的错，说明机器上有两个 Python 环境，ComfyUI 启动的是另一个环境，需要检查 run_nvidia_gpu.bat 指向的解释器路径。

来源

1. [6] （官方文档）　How to Troubleshoot and Solve ComfyUI Issues　https://docs.comfy.org/troubleshooting/overview
2. [136] （官方文档）　Common Issues and Solutions - ComfyUI　https://mintlify.wiki/Comfy-Org/ComfyUI/guides/common-issues
3. [137] （官方 issue）　AssertionError: Torch not compiled with CUDA enabled on 5060ti · Issue　https://github.com/Comfy-Org/ComfyUI/issues/7826
4. [138] （社区）　ComfyUI 'Torch not compiled with CUDA enabled'? Every Fix That Works o　https://dev.to/jovan_chan_9500711396d4e6/comfyui-torch-not-compiled-with-cuda-enabled-every-fix-that-works-on-windows-linux-and-mac-556m

这条报错要用到的东西

按本条报错所属的类别（PyTorch、CUDA 运行库与加速库冲突）列出站内相关的下载包与板块入口。 它们不是「必须下载才能修好」，而是这一类问题里最常要动到的东西；具体怎么做，以上面的解决步骤为准。

同一类别的其他条目

返回报错库