在 Ubuntu 中为 npm 切换国内镜像源

在 Ubuntu 中为 npm 切换国内镜像源可显著提升包下载速度，以下是多种方法及注意事项：

---

一、临时切换（单次命令生效）

在安装包时通过 --registry 参数指定镜像源：

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

• 适用场景：仅需临时加速某个包的安装。
• 验证镜像源 ：安装完成后运行 npm config get registry，若显示镜像地址则生效。

---

二、全局永久切换

1. 修改全局配置文件

npm config set registry https://registry.npmmirror.com

• 验证 ：执行 npm config get registry，输出应为镜像地址。

• 恢复官方源 ：

  npm config set registry https://registry.npmjs.org

2. 编辑 .npmrc 文件

在用户主目录（~/.npmrc）或项目根目录添加：

registry=https://registry.npmmirror.com

• 优先级 ：项目级 .npmrc 会覆盖全局配置。

---

三、使用 cnpm 替代 npm

淘宝提供的 cnpm 工具直接指向国内镜像：

1. 安装 cnpm ：

   npm install -g cnpm --registry=https://registry.npmmirror.com

2. 使用 cnpm ：

   cnpm install <package-name>

• 优势：与 npm 命令兼容，速度更快。

---

四、通过 nrm 管理多镜像源

nrm 是镜像源管理工具，支持快速切换和测试速度：

1. 安装 nrm ：

   npm install -g nrm

2. 查看可用源 ：

   nrm ls

   • 输出示例：

     * npm ---- https://registry.npmjs.org/
       taobao -- https://registry.npmmirror.com/
       tencent -- https://mirrors.cloud.tencent.com/npm/

3. 切换源 ：

   nrm use taobao

4. 测试速度 ：

   nrm test

• 优势：支持自定义源和批量操作。

---

五、其他国内镜像源推荐

镜像名称	地址
阿里云	https://npm.aliyun.com
腾讯云	https://mirrors.cloud.tencent.com/npm/
华为云	https://mirrors.huaweicloud.com/npm/
清华大学	https://mirrors.tuna.tsinghua.edu.cn/npm/

---

六、常见问题解决

1. 切换后仍下载缓慢：

   • 检查网络代理是否拦截镜像地址。
   • 清除 npm 缓存：npm cache clean --force。

2. C++ 模块编译失败：

   • 添加 --disturl 参数指定 Node.js 源码镜像：

     npm install <package> --registry=https://registry.npmmirror.com --disturl=https://npmmirror.com/mirrors/node

   • 或通过 cnpm 安装（自动处理依赖）。

3. 企业内网环境：

   • 联系运维配置私有镜像源（如华为云、京东云）。

---

总结

• 推荐方法 ：全局配置 npmmirror.com 或使用 cnpm。
• 开发环境 ：nrm 灵活管理多源，方便测试。
• 生产环境：固定使用阿里云/腾讯云等稳定镜像。