换源提速,告别下载慢

新手入门更新于 2026-08-17 · 约 3 分钟阅读

为什么慢#

npm 官方源 registry.npmjs.org 部署在海外,国内访问延迟高。首次用 npx 启动 DSH 时要下载整个包,动辄几分钟,甚至超时失败。换用国内镜像源后,通常几十秒就能完成。

临时换源(先试这个)#

不改动任何全局配置,只在这一次命令里指定镜像源:

npx --registry=https://registry.npmmirror.com @deepseek-ai/dsh web

registry.npmmirror.com 是淘宝维护的 npm 镜像,与官方源实时同步。适合先验证网络问题是否由源地址导致。

永久换源#

确认镜像好用后,把它设为默认源,之后所有 npm 命令都会走镜像:

npm config set registry https://registry.npmmirror.com

验证是否生效:

npm config get registry

输出镜像地址即成功。想恢复官方源时执行:

npm config set registry https://registry.npmjs.org

pnpm 用户#

DSH 的 profile 体系使用 pnpm 管理依赖,如果你的环境以 pnpm 为主,对应的换源命令是:

pnpm config set registry https://registry.npmmirror.com

验证与恢复方式与 npm 相同,把命令前缀换成 pnpm 即可。

GitHub 资源也慢#

npm 换源只解决包下载,插件本身仍从 GitHub 获取。GitHub 访问不稳定时的处理口径:

  • 配置可用的网络代理后重试
  • 换用 GitHub 镜像或加速服务(请自行评估安全性)
  • 稍后重试——偶发超时重试一次往往就好

小结与下一课#

换源是性价比最高的提速手段:临时换源用于验证,永久换源一劳永逸。上一课回顾见安装 DSH;环境顺畅后,进入下一课:安装你的第一个插件。更多网络类故障排查见安装失败排查