NPM镜像切换教程

淘宝NPM镜像站的最新官方地址为：

**https://registry.npmmirror.com**​

一、旧域名停用说明​

淘宝原NPM镜像域名（如https://registry.npm.taobao.org、http://npm.taobao.org）已正式停止服务：

• 2022年5月31日，旧域名的DNS解析停止；

• 2024年1月22日，旧域名的HTTPS证书到期，导致无法通过HTTPS访问。

因此，继续使用旧域名会报错 （如certificate has expired或DNS_PROBE_FINISHED_NXDOMAIN），需切换至新地址。

二、新地址的优势​

1. 稳定性：新域名由阿里云提供支持，服务器性能和带宽更充足，解决了旧域名因架构老化导致的同步失败、访问缓慢等问题；

2. 安全性：采用最新的SSL/TLS证书，确保数据传输安全；

3. 兼容性 ：支持所有NPM客户端（如npm、yarn、pnpm），无需修改额外配置。

三、切换新地址的方法​

1. **永久切换（推荐）**​

通过NPM命令设置默认镜像源：

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

验证是否成功：

npm config get registry  # 输出应为https://registry.npmmirror.com

2. **临时使用（单次命令）**​

若不想修改全局配置，可在安装依赖时临时指定镜像源：

npm install <包名> --registry=https://registry.npmmirror.com

3. **使用nrm管理镜像源（更便捷）**​

nrm（NPM Registry Manager）是NPM镜像源管理工具，可快速切换不同源：

• 安装nrm：

  npm install -g nrm

• 查看可用源：

  nrm ls  # 带*的为当前使用的源

• 切换至淘宝源：

  nrm use taobao  # 对应地址为https://registry.npmmirror.com

• 测试源速度（可选）：

  nrm test taobao  # 测试淘宝源的下载速度

四、常见问题解决​

1. **切换后仍无法下载？**​

   • 清除NPM缓存：npm cache clean --force；

   • 检查网络连接：确保能访问https://registry.npmmirror.com。

2. **cnpm用户需注意？**​

   若使用cnpm（淘宝官方包管理工具），需重新安装以使用新源：

   npm install -g cnpm --registry=https://registry.npmmirror.com

**五、其他镜像源推荐（备选）**​

若淘宝源不稳定，可选择以下国内镜像源：

• 阿里云NPM镜像：https://npm.aliyun.com；

• 腾讯云NPM镜像：https://mirrors.cloud.tencent.com/npm/；

• 华为云NPM镜像：https://mirrors.huaweicloud.com/repository/npm/；

• 清华大学开源镜像站：https://mirrors.tuna.tsinghua.edu.cn/npm/。

总结​

淘宝NPM镜像的最新地址是**https://registry.npmmirror.com** ，旧域名已停止服务。切换新地址可解决下载慢、报错等问题，建议通过npm config或nrm永久设置。若需备选，阿里云、腾讯云等镜像源也是可靠选择。