🚀 NRM：快速切换 npm 镜像源的管理工具指南

🔍 什么是 NRM？

NRM（Npm Registry Manager） 是一个用于管理 npm 镜像源的命令行工具。
它能帮助开发者 ⚡快速切换 不同的 npm 源（如官方源、淘宝源、腾讯云源等），解决因 🌐网络问题导致的 npm install 依赖安装缓慢或失败的问题。

---

📥 安装 NRM

⚠️ 前提条件

• ✅ 已安装 Node.js（建议 v12+）
• ✅ 已安装 npm（通常随 Node.js 自动安装）

🌍 全局安装

通过 npm 全局安装 NRM：

npm install -g nrm

🔎 验证安装

安装完成后运行：

nrm --version

若显示版本号（如 2.0.1 🎉），则说明安装成功。

---

🛠️ 基础使用

📋 查看可用镜像源列表

nrm ls

输出示例：

npm -------- https://registry.npmjs.org/yarn ------- https://registry.yarnpkg.com/cnpm ------- https://r.cnpmjs.org/taobao ----- https://registry.npmmirror.com/nj --------- https://registry.nodejitsu.com/npmMirror -- https://skimdb.npmjs.com/registry/

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

🔄 切换镜像源

nrm use <源名称>

例如切换至华为源：

nrm use huawei

⏱️ 测试源速度

测试所有源的响应速度：

nrm test

测试特定源（如 taobao）：

nrm test taobao

---

⚡ 高级功能

➕ 添加自定义镜像源

nrm add <源名称> <源地址>

示例：

nrm add company http://npm.internal.company.com/

❌ 删除镜像源

nrm del <源名称>

🔍 查看当前源

nrm current

---

❓ 常见问题

🔒 权限问题

若安装时报错 EACCES，尝试以下命令：

sudo npm install -g nrm --unsafe-perm

💻 Windows 下命令不可用

检查系统环境变量是否包含 npm 全局安装路径（如 %APPDATA%\npm）。

🐢 切换源后安装仍慢

某些依赖可能需要清除缓存后重新安装：

npm cache clean --force

---

🌟 推荐镜像源

源名称	地址	适用场景
🛒 taobao	https://registry.npmmirror.com	中国大陆用户首选
🏢 cnpm	https://r.cnpmjs.org/	企业级镜像
🏛️ npm	https://registry.npmjs.org/	官方源（国际）

---

🗑️ 卸载 NRM

npm uninstall -g nrm

验证是否卸载 NRM 成功①

npm list -g --depth=0

输出示例：

C:\Windows\system32>npm list -g --depth=0
D:\Software\nodejs\node_global
+-- @vue/cli@5.0.8
`-- cnpm@9.4.0

验证是否卸载 NRM 成功②

nrm --version

输出示例：

C:\Windows\system32>nrm --version
'nrm' 不是内部或外部命令，也不是可运行的程序
或批处理文件。

---

💡 提示

• NRM 仅管理 npm 的镜像源，不影响 yarn 或 pnpm 的配置。
• 如需管理其他包管理器的源，请使用对应工具（如 yrm 管理 yarn 源）。

---

📌 来源：https://github.com/Pana/nrm
📅 更新于：2025年5月