团队协作必备！pnpm 版本管理与 corepack 使用指南

前言

在团队项目中，我们使用 pnpm 作为包管理器。但有些同学在执行 pnpm install 安装依赖后，发现 pnpm-lock.yaml 文件发生了大量变化。这是什么原因？又该如何解决？

问题原因

虽然大家都使用 pnpm 安装依赖，但由于 pnpm 的更新频率很高（截至 2025 年 4 月 27 日，已更新至 v10 版本），不同同学电脑上安装的 pnpm 版本可能分别是 v6、v7、v8 等不同版本。

可以通过 pnpm-lock.yaml 文件顶部的 lockfileVersion 字段，了解当前项目是基于哪个 pnpm 版本管理的。

解决方案

单靠口头提醒显然不够可靠。建议在 package.json 中添加 engines 字段，明确声明项目所要求的 pnpm 版本。查看官方文档说明

json 复制代码

"engines": {
    "node": ">=12.0.0",
    "pnpm": "8.15.9"
  },

如果你本地有多个项目，每个项目用的 pnpm 版本又不一样，每次切换项目还得手动跑 npm i -g pnpm@xxx，是不是感觉超麻烦？

主播主播，有没有更方便的方法？------有的兄弟，有的！✨

可以在 package.json 里加上 packageManager 字段, 这个字段可以配合 Corepack 自动切换正确的包管理器和版本，不用你每次手动安装啦！

json 复制代码

 "engines": {
    "node": ">=12.0.0",
    "pnpm": "8.15.9"
  },
  "packageManager": "pnpm@8.15.9"

Corepack 又是什么?

Corepack 是一个由 Node.js 团队开发的工具，用于管理和简化包管理工具（如 Yarn 和 pnpm）的使用。它的主要目的是为开发者提供一个一致的方式来管理和使用这些包管理工具，而无需每次手动安装和配置。Node.js 16.9 及其以后的版本，Corepack 可以帮助你轻松使用这些包管理工具。

启动 corepack enable 后，遇到项目 package.json 中有 packageManager 字段就可以自动读取并切换了。

小坑点

有些同学可能 corepack enable 后，发现没有出现预期的自动切换效果。

一般是因为 ------ 你的 pnpm 之前是用 npm install -g pnpm 全局安装的，导致系统优先用了旧版本！

正确做法：

打开终端，执行：
bash 复制代码
```
which pnpm
```
如果输出类似 /usr/local/bin/pnpm，那就是之前手动全局装的。
卸载旧版本：
bash 复制代码
```
npm uninstall -g pnpm
```
重新启用 Corepack：
bash 复制代码
```
corepack enable
```
再次切换项目时，Corepack 就能正确管理 pnpm 版本了！
最后别忘了：
- 执行 pnpm store prune 清理缓存。
- .npmrc 文件中加上：
  ini 复制代码
```
package-manager=pnpm@x.xx.x
```
- GitLab / GitHub CI 配置文件（比如 .gitlab-ci.yml / .github/workflows/xxx.yml）也要同步修改，确保 CI 流水线用对版本！

结语

以上就是关于 Corepack 和 package.json 字段的一些小分享。

另外补充一点：未来 Corepack 将不再与 Node.js 一起捆绑发布，而是作为独立包单独维护和分发nodejs.cn/api/corepac...

尽管 Corepack 随 Node.js 的默认安装一起分发，但 Corepack 管理的包管理器不是 Node.js 分发的一部分，并且 Corepack 本身将不再随未来版本的 Node.js 一起分发。

赶快在你的项目中用起来吧 ~