ComfyUI Desktop 报 “ComfyUI requires an NVIDIA GPU on Windows. No NVIDIA GPU was detected” 卡在启动页（含被迫用 --cpu 的慢速兜底）

ComfyUI requires an NVIDIA GPU on Windows. No NVIDIA GPU was detected.
0.3.28， Your device is not supported
Only following devices are supported:
MacOS (M1 or later)
Windows (Nvidia GPU with CUDA support)

现象与触发场景

常见触发场景：

• Windows 上装了 ComfyUI Desktop，但系统里只有集显，或独显驱动不完整
• Path 环境变量被改坏导致 Desktop 探测显卡失败
• 系统缺少 wmic.exe（0.3.23 之前版本依赖它探测显卡）

根因

• ComfyUI Desktop 的 Windows 版只支持带 CUDA 的 NVIDIA GPU（macOS 要求 M1 或更新）。官方文档明确：其他 GPU（AMD/Intel）请改用 Windows 便携版或手动安装，Desktop 不支持。
• Desktop 的显卡探测早期依赖 wmic.exe，系统精简掉该组件后会误判为“没有 NVIDIA GPU”；0.3.23 起改为通过 WMI/CIM 读取，官方论坛给出的排障方法就是直接跑 CIM 查询确认 Windows 是否报告了 NVIDIA 卡。
• 另一个常见干扰是笔记本混合显卡：系统默认把应用分配给集显，Desktop 探测到的第一块设备不是 NVIDIA。
• 显卡确实不受支持时，官方认可的兜底方案是 CPU 模式（--cpu），但它的代价极高：官方文档原话是 CPU mode is significantly slower than GPU mode，实际体验上一张 SD1.5 图要几分钟、视频工作流基本跑不完。

解决步骤

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

1. 先用 CIM 查询确认 Windows 有没有报告 NVIDIA 显卡
   在 PowerShell 里执行官方论坛给出的这条命令。有正常输出（Caption/Name 里出现 NVIDIA GeForce ...）说明系统认到了卡，问题在 Desktop 的探测逻辑；完全没有输出说明驱动层面就没认到卡，先修驱动。
   powershell.exe -c "`$n = '*NVIDIA*'; Get-CimInstance win32_videocontroller | ? { `$_.Name -like `$n -or `$_.VideoProcessor -like `$n -or `$_.AdapterCompatibility -like `$n }"
2. 检查 Path 环境变量，改完注销重新登录
   确认 $env:PATH.split(';') 输出里有系统基本路径。若缺项，到系统环境变量里补回后注销并重新登录（改动不会自动生效）。
   $env:PATH.split(';')
3. 不是 NVIDIA 显卡就换便携版；是 NVIDIA 但 Desktop 仍误判就更新或改用手动安装
   官方文档写明 Desktop 的 Windows 版仅支持 CUDA 的 NVIDIA GPU，AMD/Intel 请用 Windows 便携版或手动安装。若确认是 NVIDIA 卡而 Desktop 仍报不支持，升级到较新的 Desktop 版本（探测逻辑已改为 CIM）或直接改用便携版/手动安装绕过该校验。
   git clone https://github.com/comfyanonymous/ComfyUI.git
   python main.py
4. 兜底：只有在显卡确实不受支持时才用 CPU 模式，并尽量降载
   显卡确实无法走 GPU 时（例如老 NVIDIA 卡在新版 torch 上无 kernel），官方认可的方案是 CPU 模式。用 --novram 更激进卸载、--cache-none 减少内存占用、--preview-method none 省掉预览计算，并显著下调分辨率与 batch。老 NVIDIA 卡更推荐换 CUDA 12.6 的构建回到 GPU 模式（--extra-index-url https://download.pytorch.org/whl/cu126），而不是忍受 CPU 速度。issue #7677 里 GTX 970 用户的实测反馈是：CPU 模式下约半打静态图像工作流能跑完，视频工作流一个都跑不了，且模型库需要占用极大磁盘（他为此专门用了 500GB 的 M.2）。
   python main.py --cpu --novram
   python main.py --cpu --cache-none
   python main.py --cpu --preview-method none
   pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu126

验证是否修好

补充说明

报错原文逐字取自 ComfyUI 官方论坛帖的楼主贴与第 4、5 楼；同帖第 4 楼由社区用户给出 PATH 与 CIM 两条排查命令。CPU 模式说明 Note: CPU mode is significantly slower than GPU mode. 逐字来自 ComfyUI 官方 Common Issues 文档；GTX 970 用户的 CPU 模式实测体验来自 Comfy-Org/ComfyUI issue #7677 的评论。

来源

1. [216] （官方 issue）　ComfyUI requires an NVIDIA GPU on Windows. No NVIDIA GPU was detected 　https://forum.comfy.org/t/comfyui-requires-an-nvidia-gpu-on-windows-no-nvidia-gpu-was-detected/686
2. [6] （官方文档）　How to Troubleshoot and Solve ComfyUI Issues（不支持的设备：Desktop Windows 仅支　https://docs.comfy.org/troubleshooting/overview
3. [136] （官方文档）　Common Issues and Solutions - ComfyUI（CPU 模式说明：CPU mode is significant　https://mintlify.wiki/Comfy-Org/ComfyUI/guides/common-issues
4. [211] （官方 issue）　no kernel image is available for execution on the device · Issue #7677　https://github.com/Comfy-Org/ComfyUI/issues/7677

这条报错要用到的东西

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

同一类别的其他条目

返回报错库