# 安装与启用 Corepack

URL: https://caijiao.org/corepack/install
Source: docs/corepack/install.md
Description: Corepack 从 Node.js 14.19.0 开始内置，推荐直接启用。也可通过 npm 手动安装或更新，适合对工具链有更灵活需求的用户。

## 默认安装（推荐）

Corepack 在 **Node.js 14.19.0 至 24.x** 版本中已内置。  
只需运行以下命令即可启用，并自动安装 Yarn、pnpm 到系统 PATH：

```bash
corepack enable
````

启用后即可使用 `yarn`、`pnpm` 命令，而无需手动安装。

## 手动安装

如果你使用的 Node.js 版本未内置 Corepack，或希望安装最新版本，可以通过 **npm** 手动安装。

### 1. 卸载已存在的全局 Yarn / pnpm

```bash
npm uninstall -g yarn pnpm
```

> ⚠️ 如果你是通过 `brew` 或其他方式安装的 Yarn，需要单独卸载，例如：
>
> ```bash
> brew uninstall yarn
> ```

### 2. 安装 Corepack

```bash
npm install -g corepack
```

## 更新 Corepack

要升级到最新版本，可执行：

```bash
npm install -g corepack@latest
```

## Windows 用户注意事项

如果你是通过 **Node.js Windows 安装包（.msi）** 安装的 Corepack：

* 可能需要先卸载 Node.js 安装包中的 `corepack manager` 功能。
* 方法：进入 *Windows 应用设置* → 找到 Node.js → 选择 *修改* → 在功能选择界面将 **corepack manager** 设置为 *Entire feature will be unavailable*。

参考：[微软文档 - Repair apps and programs in Windows](https://support.microsoft.com/windows/repair-apps-and-programs-in-windows)

## 总结

* **推荐方式**：直接使用 Node.js 自带的 Corepack，并执行 `corepack enable`。
* **手动方式**：如需灵活管理，可用 npm 全局安装或更新 Corepack。