'node' Is Not Recognized

先确认是不是 'node' is not recognized

这页只处理 'node' is not recognized 这一类报错。不同系统或 Node.js 版本可能多几个单词，但核心错误码或句式应该一致。

搜索或求助时尽量复制完整报错，同时删除 API Key、私有仓库名、用户名和敏感路径。

'node' is not recognized 是什么意思

当前终端找不到 Node.js，所以 npm、npx 和 DSH 命令都无法运行。

'node' is not recognized 的常见原因

• 还没有安装 Node.js。
• 安装程序没有把 Node 加入 PATH。
• 安装 Node 前终端就已经打开。
• Node 版本管理器指向旧版本或不完整安装。
• 安装了不在官方支持范围内的 Node.js 23。

'node' is not recognized 的源码依据

下面链接固定到本页核验使用的 0.1.2-alpha.5 / 49a606b。先确认 'node' is not recognized 是 DSH 自身行为，还是 Node.js、PowerShell、操作系统网络或文件权限产生的错误。

修复 'node' is not recognized

1. 01

   安装受支持的 Node.js

   DSH 官方源码要求 ^22.19.0 或 >=24.0.0。最简单的选择是 Node.js 24 或更高版本；Node.js 22 只有从 22.19.0 开始才符合要求，Node.js 23 不在范围内。

2. 02

   关闭并重新打开所有终端

   关闭 PowerShell、CMD、Terminal 和编辑器终端，再重新打开，让新终端读取更新后的 PATH。

3. 03

   检查 Node 和 npm

   在尝试启动 DSH 前，这两个命令必须在同一个终端正常返回。

   node --version npm --version
4. 04

   Windows：确认正在使用哪个 Node

   使用 where.exe 查看路径，可发现旧版本或重复安装。

   where.exe node
5. 05

   macOS 或 Linux：确认 Node 路径

   使用 command -v 查看当前 Shell 实际选中的 Node。

   command -v node
6. 06

   检查通过后再启动 DSH

   Node 和 npm 均正常，且版本符合要求后，再执行官方启动命令。

   npx @deepseek-ai/dsh web

确认 'node' is not recognized 已经修好

• node --version 返回 22.19 及以上的 22.x，或 24.x 及以上。
• 同一终端中 npm --version 可以正常返回。
• npx 开始下载或启动 DSH。

'node' is not recognized 常见问题

相关报错