pnpm 教程

pnpm 与 npm、yarn 的比较

pnpm 是一款磁盘空间高效的软件包管理器。

当使用 npm 或 yarn 时，如果你有 1000 个项目，并且所有项目都有一个相同的依赖包，那么， 你在硬盘上就需要保存 100 份该相同依赖包的副本。然而，如果是使用 pnpm，依赖包将被存放在一个统一的位置，因此以项目和依赖包的比例来看，使用 pnpm 将节省大量的硬盘空间，并且安装速度也能大大提高。

pnpm 的兼容性不如 npm，但是不影响 pnpm 的优越性

使用时，pnpm 会生成 pnpm-lock.yaml 文件，npm 会生成 package-lock.json 文件，yarn 会生成 yarn.lock 文件。

pnpm 的优势

• 快速 —— pnpm 比替代方案快 2 倍

• 高效 —— node_modules 中的文件是从一个单一的可内容寻址的存储中软链接过来的

• 支持 monorepos —— pnpm 内置支持了单仓多包

• 严格 —— pnpm 默认创建了一个非平铺的 node_modules，因此代码无法访问任意包

安装

首先你需要安装 nodejs（虽然 pnpm 可以作为独立可执行文件提供，无需安装 nodejs 也可以使用，但 emm 还是安吧）

由于 apt 源的 nodejs 版本较低，推荐使用 nvm 进行安装和管理

下载 nvm

wget https://github.com/nvm-sh/nvm/archive/refs/tags/v0.39.1.tar.gz
mkdir -p ~/.nvm
tar -zxvf nvm-0.39.1.tar.gz -C ~/.nvm

配置 nvm

在~/.bashrc中添加以下内容

export NVM_DIR="$HOME/.nvm/nvm-0.39.1"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"

之后source ~/.bashrc使配置生效

下载 nodejs

可通过nvm list available查看可下载的 nodejs 版本

通过nvm install <version>安装指定版本

通过nvm use <version>切换使用的 nodejs 版本

当然，你也可以使用nvm install --lts安装最新版本的 nodejs

随后使用node -v检查 nodejs 已安装成功

下载 pnpm

对 npm 进行换源

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

安装 pnpm

npm install -g pnpm

pnpm 无需再次换源，默认使用 npm 的源

使用pnpm -v检查 pnpm 已安装成功

常用命令

pnpm add <package> # 安装指定包
pnpm add <package> -g # 全局安装指定包
pnpm remove <package> # 移除指定包
pnpm remove <package> -g # 全局移除指定包
pnpm upgrade <package> # 升级指定包
pnpm upgrade <package> -g # 全局升级指定包
pnpm install # 安装项目依赖
pnpm dev # 运行开发环境
pnpm build # 构建项目

更细节的事情

pnpm 从命令行、环境变量和 .npmrc 文件中获取其配置。

pnpm config 命令可用于更新和编辑 用户和全局 .npmrc 文件的内容。

四个相关文件分别为：

• 每个项目的配置文件（/path/to/my/project/.npmrc）

• 每个工作区的配置文件（包含 pnpm-workspace.yaml 文件的目录）

• 每位用户的配置文件（~/.npmrc）

• 全局配置文件（/etc/npmrc）

所有 .npmrc 文件都遵循 INI-formatted 列表，包含 key = value 参数。