NPM 镜像源推荐与配置

国内访问 npm 官方源速度较慢，推荐使用国内镜像源以提升依赖安装速度。

常用 NPM 镜像源

常用命令

  • 查看当前镜像源
    npm get registry

  • 临时切换镜像源
    npm --registry=https://registry.npmmirror.com install <package>

  • 永久切换镜像源
    npm config set registry https://registry.npmmirror.com

  • 恢复官方源
    npm config set registry https://registry.npmjs.org

nrm 多镜像管理工具

nrm 可以快速切换和管理 npm 镜像源。

  • 安装 nrm
    npm i -g nrm

  • 查看可用镜像列表
    nrm ls

  • 切换镜像源
    nrm use taobao

  • 添加自定义镜像
    nrm add <name> <url>

配置文件

镜像源设置权重：命令行 > 项目 .npmrc > 全局 .npmrc > 默认镜像源

  • .npmrc
1
registry=https://registry.npmmirror.com
  • .yarnrc
1
registry "https://registry.npmmirror.com"

搭建本地 npm 镜像

如需在局域网内搭建私有 npm 镜像，可使用 verdaccio：

  1. 全局安装 verdaccio
    npm install -g verdaccio

  2. 启动服务
    verdaccio

  3. 默认监听 4873 端口，访问 http://localhost:4873/

  4. 配置本地 registry
    npm set registry http://localhost:4873/

常见问题

  • Q: 切换镜像后安装依赖仍然很慢？
    A: 检查是否有 .npmrc 文件覆盖了 registry 设置，或尝试清理缓存：npm cache clean --force。

  • Q: 镜像源同步延迟？
    A: 国内镜像与官方源有同步延迟，部分新包可能暂时无法获取。

  • Q: 如何还原为官方源？
    A: 执行 npm config set registry https://registry.npmjs.org。

如有更多问题，欢迎留言交流。