npm / npx Is Not Recognized
修复 npm 或 npx is not recognized：在同一终端检查 node、npm、npx，修复 Node.js，并区分 PATH 与 PowerShell 策略问题。
本页内容
先确认是不是 npm / npx is not recognized
这页只处理 npm / npx is not recognized 这一类报错。不同系统或 Node.js 版本可能多几个单词，但核心错误码或句式应该一致。
npm / npx is not recognized'npx' is not recognized'npm' is not recognizednpx command not foundnpm command not found搜索或求助时尽量复制完整报错，同时删除 API Key、私有仓库名、用户名和敏感路径。
在同一终端执行 node --version、npm --version 和 npx --version。如果 node 正常但 npm 或 npx 不存在，修复 Node.js 安装并重新打开终端。如果报错明确写着 npm.ps1 cannot be loaded，请改看 PowerShell 专用解决方案。
npm / npx is not recognized 是什么意思
Node 可能已经安装，但 npm 或 npx 没有进入 PATH、安装不完整，或者 PowerShell 阻止了对应脚本。
npm / npx is not recognized 的常见原因
- Node.js 安装不完整，npm 没有正确安装。
- PATH 只包含 node.exe，没有 npm 命令目录。
- Node 版本管理器指向不完整版本。
- 当前终端仍保留旧 PATH。
- PowerShell 执行策略阻止了 npm.ps1 或 npx.ps1。
npm / npx is not recognized 的源码依据
下面链接固定到本页核验使用的 0.1.2-alpha.5 / 49a606b。先确认 npm / npx is not recognized 是 DSH 自身行为，还是 Node.js、PowerShell、操作系统网络或文件权限产生的错误。
修复 npm / npx is not recognized
- 01
检查三个命令
在同一个终端依次执行，先确认到底是哪一个命令失败。
node --version npm --version npx --version - 02
看清 PowerShell 的完整报错
如果报错写着 npm.ps1 或 npx.ps1 因脚本被禁用而无法加载，先看相关 PowerShell 页面，不要急着重装 Node。
- 03
修复 Node.js 安装
使用 Node 官方安装程序或 Node 版本管理器，重新安装包含 npm 的受支持版本。
- 04
重新打开终端
关闭现有 Shell 和编辑器终端，让新终端读取修复后的 PATH。
- 05
重新启动 DSH
npm 和 npx 都能返回版本后，再执行官方启动命令。
npx @deepseek-ai/dsh web
确认 npm / npx is not recognized 已经修好
- npm --version 和 npx --version 都能返回版本。
- 同一终端可以启动 DSH。
- 不要安装随机的独立 npx 包来掩盖损坏的 Node 安装。
- PATH 问题不要第一步就使用管理员权限。
- 不要把 PowerShell 执行策略报错误判成 npm 未安装。
npm / npx is not recognized 常见问题
npm / npx is not recognized 怎么修？
在同一终端执行 node --version、npm --version 和 npx --version。如果 node 正常但 npm 或 npx 不存在，修复 Node.js 安装并重新打开终端。如果报错明确写着 npm.ps1 cannot be loaded，请改看 PowerShell 专用解决方案。
npm / npx is not recognized 是什么意思？
Node 可能已经安装，但 npm 或 npx 没有进入 PATH、安装不完整，或者 PowerShell 阻止了对应脚本。
怎么确认 npm / npx is not recognized 已经修好？
npm --version 和 npx --version 都能返回版本。 同一终端可以启动 DSH。
本页于 2026-09-03 对照官方仓库核验。网站使用的已发布版本基线为 0.1.1-rc.2；源码核验快照为 0.1.2-alpha.5（49a606b）。