在 cmd 里敲 nvidia-smi 提示“不是内部或外部命令”——驱动装的是 DCH/未装 NVIDIA 驱动或 PATH 里没有 System32

nvidia-smi 不是内部或外部命令，也不是可运行的程序或批处理文件。
（注：以上为转述文本，非逐字原文。）

现象与触发场景

常见触发场景：

• 新装/重装 Windows，只用了系统自动推送的显示驱动，没装官方 NVIDIA 驱动
• 系统环境变量 Path 被某些软件改坏，缺了 C:\WINDOWS\system32
• Linux 内核更新后驱动模块没加载，或与 nouveau 冲突（同一报错文本的 Linux 版本）

根因

• nvidia-smi.exe 随 NVIDIA 驱动一起安装到 System32（Windows）或 /usr/bin（Linux）。驱动没装或装了不完整（例如只装了 Windows Update 推的 DCH 基础显示驱动）时，这个工具就不存在。
• 另一个原因是环境变量 Path 被改动，Windows 找不到 System32；官方论坛给出的排查方法是打印 $env:PATH.split(';') 看有没有 C:\WINDOWS\system32 等项，改动 Path 后需要注销/重新登录才生效。
• 提示 NVIDIA-SMI has failed because it couldn't communicate with the NVIDIA driver 时，工具本身在，是驱动模块没起来——Windows 上通常是驱动损坏/被安全软件拦截，Linux 上常见于内核更新后未重建模块或 nouveau 占用。

解决步骤

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

1. 先确认 Path 是否完整（Windows）
   在 PowerShell 里打印 Path 的每一项，确认包含 C:\WINDOWS\system32、C:\WINDOWS、C:\WINDOWS\System32\Wbem、C:\WINDOWS\System32\WindowsPowerShell\v1.0\ 等基本项；若缺项，去“系统属性 → 环境变量 → 系统变量 Path”里补回，然后注销并重新登录使改动生效（官方论坛原话：改动 Path 不会自动生效，最简单可靠的生效方式是注销 Windows 再登录）。
   $env:PATH.split(';')
   $env:SystemRoot
2. 用 WMI/CIM 直接查 Windows 是否报告了 NVIDIA 显卡
   这是 ComfyUI 官方论坛在 0.3.23 引入的检查方法（因为系统里可能缺少 wmic.exe）：直接读 Windows 记录的显卡信息，若有输出说明系统层面认到了 NVIDIA 卡，若没有任何输出则说明 Windows 根本没报告这张卡，需要先解决驱动。
   powershell.exe -c "`$n = '*NVIDIA*'; Get-CimInstance win32_videocontroller | ? { `$_.Name -like `$n -or `$_.VideoProcessor -like `$n -or `$_.AdapterCompatibility -like `$n }"
3. 到 NVIDIA 官网重装官方驱动并重启
   不要依赖 Windows Update 推送的显示驱动。到 NVIDIA 官网按显卡型号下载 Game Ready 或 Studio 驱动，安装时勾选“执行清洁安装”，装完重启，再在 cmd 里跑 nvidia-smi。Linux 上同样是先确认 nvidia-smi 能否运行，再处理内核模块/nouveau 冲突。
   nvidia-smi
   nvidia-smi --query-gpu=driver_version,name --format=csv

验证是否修好

补充说明

“不是内部或外部命令”是中文 Windows 的典型转述，未找到逐字的中文原文页面，故 error_text_verbatim=false；英文侧同义报错为 'nvidia-smi' is not recognized as an internal or external command。PATH 检查与 CIM 检查两条命令逐字取自 ComfyUI 官方论坛的排障回复。NVIDIA-SMI has failed because it couldn't communicate with the NVIDIA driver 这条文本来自搜索结果中的第三方页面，属社区转述，未逐字核实。

来源

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. [215] （官方文档）　GPU Troubleshooting - ComfyUI（CUDA not detected 的检查命令）　https://mintlify.wiki/Comfy-Org/ComfyUI/guides/gpu-troubleshooting

这条报错要用到的东西

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

同一类别的其他条目

返回报错库