corepack使用指南

什么是 Corepack？

Corepack 是 Node.js 从 v16.9.0 起引入的实验性功能，从 v16.10.0 起默认随 Node.js 安装（在 v18+ 中为稳定特性）。它是一个桥接工具，用来自动下载并管理 Node.js 包管理器（如 Yarn、pnpm），无需手动全局安装它们。

📌 目的：确保跨项目、跨团队使用一致的包管理器版本。

在某些 Node.js 版本中，Corepack 默认未启用。你可以用以下命令启用它：

bash 复制代码

corepack enable

查看当前支持的包管理器版本：

sql 复制代码

corepack prepare --help

命令	作用
`corepack enable`	启用 Corepack 支持的包管理器
`corepack disable`	禁用 Corepack
`corepack prepare <package>@<version> --activate`	下载并激活指定版本的包管理器
`corepack use <package>@<version>`	为当前项目使用特定版本
`corepack install`	安装依赖（与 npm/yarn/pnpm install 类似）

sql 复制代码

corepack prepare yarn@3.6.4 --activate
corepack prepare pnpm@8.10.0 --activate

或者指定当前项目使用的版本（推荐）：

perl 复制代码

corepack use yarn@3.6.4
corepack use pnpm@10.13.1

这会在项目中生成或修改 .yarnrc.yml，锁定 Yarn 版本。

在项目根目录添加 packageManager 字段到 package.json：

perl 复制代码

{
  "packageManager": "yarn@3.6.4"
}

或者使用 pnpm：

perl 复制代码

{
  "packageManager": "pnpm@8.10.0"
}

Corepack 会自动读取并使用这个版本。

在 CI 中使用 Corepack 可以保证一致性。示例：

bash 复制代码

corepack enable
corepack install

想升级 Yarn：

sql 复制代码

corepack prepare yarn@latest --activate

或者指定具体版本：

sql 复制代码

corepack prepare yarn@4.1.0 --activate

使用 Corepack 可以避免版本漂移，不同项目可以使用不同版本，防止开发/构建不一致。

你可以直接使用 yarn 或 pnpm 命令，Corepack 会自动处理调用（如果你已启用 Corepack 并准备好版本）。