Nodejs 国内镜像

一般情况下，nodejs 安装依赖推荐使用官方镜像源（可以确保来源的可靠性和时效性）。但是偶尔会遇到安装的依赖比较大，而直接下载的速度会比较慢，容易出现断连的情况。切换到国内的镜像源可以很好地解决问题。

• 概述
• npm / pnpm
• yarn
  • v2/v3
  • v1
• 备注
• 参考链接

概述

常见的安装工具有 npm, yarn 和 pnpm 命令。不同的工具设置镜像源的方式还是有部分区别的。

国内的比较出名且可靠的镜像站就是阿里的：

• 阿里 npm 镜像网站：https://npmmirror.com
• 阿里 npm 镜像源链接：https://registry.npmmirror.com
• 官方 npm 镜像源链接：https://registry.npmjs.org

npm / pnpm

pnpm 的命令基本遵循 npm 命令。

# 查看源
npm get registry
npm config get registry

# 使用参数修改本次安装源
npm --registry https://registry.npmmirror.com install <XXX>

# 长期修改
npm config set registry https://registry.npmmirror.com

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

npm 可以从命令行，环境变量或者 npmrc 文件读取配置文件。常见的 npmrc 配置文件有：

• 每个项目的配置文件 (/path/to/my/project/.npmrc)
• 每个用户的配置文件 (~/.npmrc)
• 全局配置文件 ($PREFIX/etc/npmrc)
• npm 内置配置 (/path/to/npm/npmrc)

registry=https://registry.npmjs.org

yarn

yarn 默认官方源不是 npm 官方源，且 yarn 1.x 版本和 2.x/3.x 版本命令有很大区别。

v2/v3

在 yarn v2/v3 版本中， registry 关键字变成了 npmRegistryServer。yarn 所有的命令可以查看 https://yarnpkg.com/cli

# 查看所有配置
yarn config

# 查看源
yarn config get npmRegistryServer

yarn 设置源必须要在项目根目录下。直接设置会得到如下的错误

Usage Error: This command must be run from within a project folder

# 设置源
yarn config set npmRegistryServer https://registry.npmmirror.com

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

v1

yarn v1 的命令比较像 npm 的命令。

# 查看所有配置
yarn config get registry

# 更换阿里源
yarn config set registry https://registry.npmmirror.com

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

备注

Electron 镜像处理有点区别，请查看 安装 Electron 相关的问题

参考链接

• npmrc
• yarn