🚀 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月