'node' Is Not Recognized
修复 'node' is not recognized：安装受支持的 Node.js，重新打开终端，检查 PATH，并先确认 node 与 npm 正常。
本页内容
核对错误信息
在页面或终端中查找下面的错误码或提示词。完整信息可能因操作系统和版本不同而略有差异。
'node' is not recognizednode is not recognized as an internal or external commandnode command not foundnode is not recognized / command not found搜索或求助时尽量复制完整报错，同时删除 API Key、私有仓库名、用户名和敏感路径。
安装所用 DSH 版本支持的 Node.js。v0.2.2-alpha.2 要求 24.9 或以上。安装后关闭所有终端，重新打开，再执行 node --version。
错误含义
当前终端找不到 Node.js，所以 npm、npx 和 DSH 命令都无法运行。
常见原因
- 还没有安装 Node.js。
- 安装程序没有把 Node 加入 PATH。
- 安装 Node 前终端就已经打开。
- Node 版本管理器指向旧版本或不完整安装。
- 安装了不在官方支持范围内的 Node.js 23。
对应文档与源码
DSH 相关链接固定到 0.1.5-rc.2 / c291e79；涉及系统和运行环境的说明见对应官方文档。
修复步骤
- 01
安装受支持的 Node.js
历史 DSH 源码快照要求 ^22.19.0 或 >=24.0.0；v0.2.2-alpha.2 要求 >=24.9.0。请按实际使用的包版本核对。
- 02
关闭并重新打开所有终端
关闭 PowerShell、CMD、Terminal 和编辑器终端，再重新打开，让新终端读取更新后的 PATH。
- 03
检查 Node 和 npm
在尝试启动 DSH 前，这两个命令必须在同一个终端正常返回。
node --version npm --version - 04
Windows：确认正在使用哪个 Node
使用 where.exe 查看路径，可发现旧版本或重复安装。
where.exe node - 05
macOS 或 Linux：确认 Node 路径
使用 command -v 查看当前 Shell 实际选中的 Node。
command -v node - 06
检查通过后再启动 DSH
Node 和 npm 均正常，且版本符合要求后，再执行官方启动命令。
npx @deepseek-ai/dsh web
检查结果
- node --version 符合所用 DSH 版本的要求（v0.2.2-alpha.2 至少为 24.9.0）。
- 同一终端中 npm --version 可以正常返回。
- npx 开始下载或启动 DSH。
- 不要使用 Node.js 23 运行 DSH。
- Node 尚不可用时，不要去排查模型服务商或工作区配置。
- 安装 Node 后不要继续使用安装前已经打开的旧终端。
常见问题速查
'node' is not recognized 怎么修？
安装所用 DSH 版本支持的 Node.js。v0.2.2-alpha.2 要求 24.9 或以上。安装后关闭所有终端，重新打开，再执行 node --version。
'node' is not recognized 是什么意思？
当前终端找不到 Node.js，所以 npm、npx 和 DSH 命令都无法运行。
怎么确认 'node' is not recognized 已经修好？
node --version 符合所用 DSH 版本的要求（v0.2.2-alpha.2 至少为 24.9.0）。 同一终端中 npm --version 可以正常返回。 npx 开始下载或启动 DSH。
本页于 2026-09-11 对照官方仓库核验。网站使用的已发布版本基线为 0.1.5-rc.1；源码核验快照为 0.1.5-rc.2（c291e79）。