教程 05 · 排错
dsh 命令找不到怎么办:command not found 排查
dsh 提示 command not found 怎么办:先分清你是用 npx 还是源码方式,再查 PATH、Node 版本和 profile。官方 README 只教 npx 与源码两种运行方式,按对应路线排查,不要混用命令。文中命令均可在官方仓库核对,数据更新于 2026-11-20。
症状 / 是什么
你在终端输入 dsh,系统说找不到这个命令;或者你照着某个教程输入了 dsh web,但官方 README 里的示例是 npx @deepseek-ai/dsh web。
为什么会这样
dsh 这个词在不同的安装方式里含义不同:
- npx 方式:
npx @deepseek-ai/dsh web会临时解析并执行 npm 包,不保证在系统里留下一个叫dsh的全局命令。 - 源码方式:官方 README 用
pnpm dsh web启动,命令由仓库里的脚本提供,同样不是系统全局的dsh。 - 其他方式:如果你从别处装过全局命令,才会在 PATH 里出现
dsh。
所以「找不到 dsh」很可能不是装坏了,而是你用了不带全局命令的安装方式。
步骤
1. 先回到官方命令
如果你是照官方 README 装的,直接用完整命令:
npx @deepseek-ai/dsh web
不要把它简写成 dsh web。npx 每次会检查包,第一次会下载,之后走缓存。
2. 源码方式用 pnpm 脚本
在仓库目录里:
pnpm dsh web
不是 dsh web,也不是 pnpm dsh 后随便加参数;按 README 的写法来。
3. 如果你确实装过全局命令
先确认它真的装上了:查全局包列表,看有没有对应的包;再确认全局 bin 目录在 PATH 里。macOS/Linux 和 Windows 的全局目录不同,用 npm prefix -g 看实际位置,把它加进 PATH。
4. 确认 Node 版本和实际使用的 Node
跑 node -v,对照 npm 包声明的 engines。如果你用 nvm、fnm 这类版本管理器,可能装在一个版本里、当前用的是另一个;切换后重新装一次。
5. 新开一个终端窗口
改完 PATH 或重装后,旧窗口里的 PATH 还是旧的。这是最常见的「明明改了还是不行」。
常见坑
- 把 npx 命令拆开。
npx @deepseek-ai/dsh web是一个整体,不要只记后半段。 - 在错误的目录找 pnpm 脚本。 源码方式要先
cd deepseek-harness,再pnpm dsh web。 - 版本管理器切来切去。 装和运行不在同一个 Node 版本里,命令会时有时无。
- PATH 里有多个同名命令。 用
which dsh(Windows 用where dsh)看实际命中的是哪一个。
相关
相关插件
- dsh-tui 怎么安装使用:有自己的启动器和 profile,最容易遇到命令问题。
- dsh-market 怎么安装使用:用图形界面装插件,少碰命令行。
常见问题
为什么官方 README 不教全局安装 dsh?
官方 README 给的是 npx 和源码两种运行方式,没有把全局命令作为推荐路径。按官方方式用时,`dsh` 不是必须存在的命令。
npx 每次启动都很慢怎么办?
npx 会检查并缓存包;慢通常发生在首次下载或网络不稳定时。可以改用源码方式,或按你所用插件的 README 选择固定安装方式。
Windows 上提示不是内部或外部命令,和 macOS 一样排查吗?
思路一样:先确认你用的是不是完整命令,再查 PATH、Node 版本和实际命中的可执行文件。Windows 用 `where`,macOS/Linux 用 `which`。