第一部分 概述

在国内网络环境下，npm、yarn、pnpm等Node.js包管理工具默认连接海外官方源时，常面临访问延迟高、连接不稳定等问题。本文系统梳理主流包管理工具的国内镜像源配置方法，涵盖镜像源选择、配置命令、验证流程及常见问题排查，为开发者提供可落地的解决方案。

第二部分 npm镜像源配置

2.1 国内镜像源选型

镜像源	地址	特点
淘宝镜像	https://registry.npmmirror.com/	同步频率高，社区使用广泛
腾讯云镜像	https://mirrors.cloud.tencent.com/npm/	企业级基础设施，稳定性强
cnpm	https://r.cnpmjs.org/	独立客户端，完整镜像同步

2.2 配置命令

bash
# 查看当前镜像源
npm get registry

# 设置为淘宝镜像源
npm config set registry https://registry.npmmirror.com/

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

2.3 配置验证

执行 npm get registry，若输出地址与配置目标一致，则表明切换成功。

第三部分 yarn镜像源配置

3.1 镜像源选型

yarn兼容npm镜像源格式，可直接复用淘宝或腾讯云镜像地址。

镜像源	地址
淘宝镜像	https://registry.npmmirror.com/
腾讯云镜像	https://mirrors.cloud.tencent.com/npm/
yarn 官方	https://registry.yarnpkg.com/

3.2 配置命令

bash
# 查看当前镜像源
yarn config get registry

# 设置为淘宝镜像源
yarn config set registry https://registry.npmmirror.com/

# 恢复官方源
yarn config set registry https://registry.yarnpkg.com/

3.3 配置验证

执行 yarn config get registry 确认输出地址。

第四部分 pnpm镜像源配置

4.1 镜像源选型

pnpm与npm共享配置文件机制，镜像源地址通用。

4.2 配置命令

bash
# 查看当前镜像源
pnpm get registry

# 设置为淘宝镜像源
pnpm config set registry https://registry.npmmirror.com/

# 恢复官方源
pnpm config set registry https://registry.npmjs.org/

4.3 配置验证

执行 pnpm get registry 确认输出地址。

第五部分 多镜像源管理工具：nrm

当需要在多个镜像源间频繁切换时，可使用nrm（NPM Registry Manager）简化操作流程。

5.1 安装

bash
npm install nrm -g

5.2 核心命令

bash
# 列出可用镜像源
nrm ls

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

# 删除镜像源
nrm del <name>

# 切换当前镜像源
nrm use <name>

# 测速对比
nrm test