NodeJS 依赖下载及切换下载源

简介

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

使用

初始化项目。

npm init
yarn init
pnpm init
1
2
3

下载依赖。

npm install axios
yarn add axios
pnpm add axios
1
2
3

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

npm install
yarn install
pnpm install
1
2
3

移除依赖。

npm remove axios
yarn remove axios
pnpm remove axios
1
2
3

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

• npm
• yarn
• pnpm

切换下载源

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

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

运行时临时指定

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

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

使用配置文件

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

项目级配置文件

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

registry=https://registry.npmmirror.com
1

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

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

为方便支持其他工具，建议在 .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
1
2
3

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

npm config get registry
1

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

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

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

国内源

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