当前位置：首页 > news >正文

npm镜像源配置指南

news 2025/9/25 14:09:53

🤟致敬读者

📘博主相关

📃文章前言

在这里插入图片描述

为了提升 npm 的下载速度与稳定性，配置国内镜像源是一个非常有效的办法。以下为当前主流且可用的国内镜像源地址和详细的配置方法。

下表列出了几个常用且可靠的国内 npm 镜像源，您可以根据自己的网络情况选择其中一个使用。

镜像源提供方	镜像地址 (Registry URL)	特点说明
淘宝 NPM 镜像	`https://registry.npmmirror.com/`	目前国内使用最广泛的镜像，同步频率高。请注意，其旧地址 `npm.taobao.org` 已废弃，请使用新地址。
腾讯云 NPM 镜像	`https://mirrors.cloud.tencent.com/npm/`	由腾讯云提供，服务稳定，是另一个不错的选择。
华为云 NPM 镜像	`https://mirrors.huaweicloud.com/repository/npm/`	华为云提供的镜像，有用户反馈对某些包（如 `better-sqlite3`）的支持较好。
清华大学开源镜像站	`https://mirrors.tuna.tsinghua.edu.cn/npm/`	国内知名的高校镜像站，更新及时。
中国科学技术大学镜像站	`https://mirrors.ustc.edu.cn/npm/`	另一所备受推崇的高校镜像源。

先查看当前使用的默认的地址如下
在这里插入图片描述

您可以根据需要选择以下三种方式之一进行配置。

这是最直接的方法，一次性设置后，后续所有的 npm install 命令都会使用新源。

设置国内镜像源：在终端中运行以下命令（以淘宝镜像为例）：
```
npm config set registry https://registry.npmmirror.com/
```
验证是否设置成功：运行以下命令，检查输出结果是否为刚设置的镜像地址。
```
npm config get registry
```
恢复官方源：如果需要切回 npm 官方源，只需执行：
```
npm config set registry https://registry.npmjs.org/
```

如果只是偶尔需要加速某个包的安装，可以在 npm install 命令后加上 --registry 参数。

npm install <package-name> --registry=https://registry.npmmirror.com/

nrm (NPM Registry Manager) 是一个专门用于快速切换 npm 源的小工具，非常方便。

安装 nrm：
```
npm install -g nrm
```
列出可用的所有镜像源：
```
nrm ls
```
通常会输出类似下面的列表：
- npm -------- https://registry.npmjs.org/
  yarn ------- https://registry.yarnpkg.com/
  taobao ----- https://registry.npmmirror.com/
  tencent ---- https://mirrors.cloud.tencent.com/npm/
  …
切换镜像源：
```
nrm use taobao  # 切换到淘宝源
```
测试镜像源速度：你可以测试各个源的响应速度，从而选择最快的一个。
```
nrm test
```

地址更新：特别留意，淘宝 NPM 镜像的域名已从旧的 npm.taobao.org 统一迁移至 registry.npmmirror.com，请确保您使用的是新地址以避免问题。
特殊包处理：绝大多数公共包都可以从国内镜像源正常下载。但对于一些需要编译或非常冷门的包，如果遇到问题，可以尝试切换回官方源或其他镜像源。
项目级配置：上述配置是作用于用户全局的。如果希望在某个特定项目中使用不同的源，可以在项目根目录下创建 .npmrc 文件并写入 registry=https://registry.npmmirror.com。

希望这些信息能帮助您顺利完成配置！如果您在操作过程中遇到任何问题，或者想了解针对特定开发场景（如使用 yarn 或 pnpm）的配置方法，我很乐意提供进一步的帮助。

在这里插入图片描述