NodeJS 依赖下载及切换下载源

简介

任何编程语言都有依赖仓库，而 NodeJS 的官方依赖仓库就是 npmjs 。NodeJS 也提供了官方的工具 npm（Node Package Manager）来安装依赖。但是 npm 也存在一些问题，因此也有不少第三方的更容易使用的包管理工具，如 yarn，pnmp 等，它们兼容 npmjs 仓库，同时提供了例如缓存、稳定性和速度优化等功能。

使用

初始化项目。

npm init
yarn init
pnpm init

下载依赖。

npm install axios
yarn add axios
pnpm add axios

安装项目的依赖，工具会根据 package.json 或其他 lock 文件下载所有依赖。

npm install
yarn install
pnpm install

移除依赖。

npm remove axios
yarn remove axios
pnpm remove axios

详细的使用可以参考官方文档：

• npm
• yarn
• pnpm

切换下载源

从官方源下载依赖，对于国内非常慢。我们可以使用像 cnpm 这样的工具。它是专门用于国内的 npm 客户端，与 npm 是完全一样的子命令。

另一种更简单的方法就是直接修改上面工具的镜像源为国内的源，这样只需要配置就可以大大加快下载速度，而且也可以用于配置私有的镜像源。

运行时临时指定

可以在运行时临时指定下载的镜像源。

npm install axios --registry https://registry.npmmirror.com
yarn install axios --registry https://registry.npmmirror.com

使用配置文件

在配置文件中可配置镜像仓库地址，这样就不用每次都输入了。

项目级配置文件

在项目根目录中添加 .npmrc 文件，添加以下内容。

registry=https://registry.npmmirror.com

yarn，pnpm 也支持 .npmrc，同时 yarn 还提供了自己的配置文件 .yarnrc。

registry "https://registry.npmmirror.com"

为方便支持其他工具，建议在 .npmrc 中配置。

全局配置

通过命令配置。

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

使用 get 即可查看当前配置。

npm config get registry

全部配置文件的位置一般在 npm 的安装路径下的 etc/npmrc，在不同的系统下位置可能不同。另外 npm 还支持用户家目录下的配置文件 ~/.npmrc。但还是建议使用命令行来配置。

配置优先级一般为：命令行参数 > 项目配置 > 用户配置 > 系统配置。

注意：如果项目中存在 package-lock.json 或 yarn.lock 等锁文件，其中已经包含了依赖的下载路径，配置就不会起作用。只能删除锁文件重建。

国内源

国内源推荐 https://www.npmmirror.com/ ，是阿里提供了镜像源，速度非常快，cnpm 就是他们提供的官方工具。之前的淘宝镜像源 registry.npm.taobao.org 已经迁移到了这个新域名。