🚀 nrm —— Node.js 镜像源一键切换工具详解（含安装、使用、进阶技巧）✨

在国内开发 Node.js 项目时，大家经常会遇到 npm 安装依赖速度慢、网络不稳定等问题。为了解决这个痛点，很多开发者会选择切换到国内的 npm 镜像源，比如淘宝、腾讯、华为等。
但每次手动切换镜像源非常麻烦，这时候 nrm（NPM Registry Manager）就派上用场了！

本文将详细介绍 nrm 的安装、使用方法、常见问题及进阶技巧，帮助你高效管理和切换 npm 镜像源。🌟

---

🧐 一、nrm 是什么？

nrm（NPM Registry Manager）是一个命令行工具，可以帮助你一键切换 npm 镜像源，支持 npm、yarn、pnpm 等主流包管理器。
它内置了多个常用的国内外镜像源，并支持自定义添加、删除镜像源，非常适合中国开发者使用。

---

🛠️ 二、nrm 安装方法

nrm 支持多种包管理器全局安装，推荐使用 npm 安装：

# 使用 npm 安装
npm install -g nrm

# 使用 yarn 安装
yarn global add nrm

# 使用 pnpm 安装
pnpm add -g nrm

安装完成后，在命令行输入 nrm -V，可以看到版本号，说明安装成功。✅

---

📚 三、nrm 常用命令详解

1️⃣ 查看所有可用镜像源

nrm ls

示例输出：

* npm ---------- https://registry.npmjs.org/
  yarn --------- https://registry.yarnpkg.com/
  tencent ------ https://mirrors.tencent.com/npm/
  cnpm --------- https://r.cnpmjs.org/
  taobao ------- https://registry.npmmirror.com/
  npmMirror ---- https://skimdb.npmjs.com/registry/
  huawei ------- https://repo.huaweicloud.com/repository/npm/

* 号表示当前正在使用的镜像源。

---

2️⃣ 切换镜像源

比如切换到淘宝镜像：

nrm use taobao

输出：

SUCCESS The registry has been changed to 'taobao'.

此时你再用 npm install，就是走的淘宝镜像，速度会快很多 🚄。

---

3️⃣ 添加自定义镜像源

如果你有自己的私有 npm 镜像，可以这样添加：

nrm add mysource https://your.custom.registry/

---

4️⃣ 删除镜像源

nrm del mysource

---

5️⃣ 测试所有镜像源响应速度

nrm test

可以快速对比各个镜像源的网络速度，选择最快的那个 🏆。

---

🎯 四、常见用途与场景

• 🚀 加速依赖安装：切换到国内镜像源（如 taobao、tencent、huawei），大幅提升依赖安装速度。
• 🔄 恢复官方源：需要用官方 npm 源时，执行 nrm use npm 即可。
• 👥 团队协作：统一团队开发环境，避免“我这能装你那装不了”的尴尬。
• 🏢 私有源管理：支持自定义添加、切换公司内部 npm 镜像。

---

🧐 五、常见问题与解决办法

❓ 切换镜像源后依然很慢？

• 检查是否有 .npmrc 文件覆盖了 registry 设置。
• 可以用 npm config get registry 查看当前实际生效的源。

❓ nrm 支持 yarn、pnpm 吗？

• nrm 主要管理 npm 的 registry，但 yarn、pnpm 也会读取 npm registry 配置，所以同样生效。
• 如果你用的是 yarn 2.x 及以上，建议用 yarn config set registry <url> 单独设置。

❓ 如何查看当前使用的镜像源？

npm config get registry

---

💡 六、进阶技巧

🌈 1. 手动修改 .npmrc 文件

有时候你想彻底自定义，可以直接编辑用户目录下的 .npmrc 文件：

registry=https://registry.npmmirror.com/

🌈 2. 配合 npx 使用

临时切换镜像源安装某个包：

npx --registry=https://registry.npmmirror.com/ create-react-app myapp

🌈 3. 结合 CI/CD

在自动化脚本中用 nrm 切换镜像源，保证构建速度和稳定性。

---

📖 七、参考资料

• nrm 官方 GitHub
• 淘宝 NPM 镜像
• npm 官方文档