npm / npx Is Not Recognized

核对错误信息

在页面或终端中查找下面的错误码或提示词。完整信息可能因操作系统和版本不同而略有差异。

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

错误含义

Node 可能已经安装，但 npm 或 npx 没有进入 PATH、安装不完整，或者 PowerShell 阻止了对应脚本。

常见原因

• Node.js 安装不完整，npm 没有正确安装。
• PATH 只包含 node.exe，没有 npm 命令目录。
• Node 版本管理器指向不完整版本。
• 当前终端仍保留旧 PATH。
• PowerShell 执行策略阻止了 npm.ps1 或 npx.ps1。

对应文档与源码

DSH 相关链接固定到 0.1.5-rc.2 / c291e79；涉及系统和运行环境的说明见对应官方文档。

修复步骤

1. 01

   检查三个命令

   在同一个终端依次执行，先确认到底是哪一个命令失败。

   node --version npm --version npx --version复制代码
2. 02

   看清 PowerShell 的完整报错

   如果报错写着 npm.ps1 或 npx.ps1 因脚本被禁用而无法加载，先看相关 PowerShell 页面，不要急着重装 Node。

3. 03

   修复 Node.js 安装

   使用 Node 官方安装程序或 Node 版本管理器，重新安装包含 npm 的受支持版本。

4. 04

   重新打开终端

   关闭现有 Shell 和编辑器终端，让新终端读取修复后的 PATH。

5. 05

   重新启动 DSH

   npm 和 npx 都能返回版本后，再执行官方启动命令。

   npx @deepseek-ai/dsh web复制代码

检查结果

• npm --version 和 npx --version 都能返回版本。
• 同一终端可以启动 DSH。

常见问题速查

相关报错