できない.dev

Corepack

別名: corepack enable / packageManager フィールド / コアパック

package.json の packageManager フィールドを見て、指定どおりのバージョンの pnpm / Yarn / npm を自動で用意する Node.js 同梱のシム。
チーム内のパッケージマネージャ差異をなくす。

公開: 更新:

定義

Corepack は、Node.js が同梱するパッケージマネージャ用のシム(薄い中継役)である。
package.json の packageManager フィールドに書かれたバージョンを読み、必要なら該当バージョンの pnpm や Yarn をダウンロードしてから実処理を委譲する。
狙いは、開発者が個別にインストールしなくても、リポジトリが指定したバージョンに揃えることにある。

詳細

packageManager は "pnpm@9.12.0" のようにパッケージ名とバージョンを固定で書く。
Corepack を有効にした環境で pnpm install を叩くと、Corepack が間に入って指定バージョンを用意する。
有効化には明示的な操作が必要で、次のコマンドを 1 度だけ実行する。

corepack enable          # pnpm / yarn のシムを PATH に置く(npm は対象外)
corepack enable pnpm     # 特定のマネージャだけ有効化する

Node.js には長く同梱されてきたが、Node.js 25 以降の公式配布物には含まれない。
その環境では npm install -g corepack で別途入れる。

よくある誤解

  • Corepack はパッケージマネージャ本体ではない。
    バージョンを解決して、本物のバイナリへ橋渡しするだけである。
  • 有効化しなければ効かない。
    既定では無効で、corepack enable を打つまでシムは置かれず、pnpm: command not found のままになる。
  • packageManager を書いても、CI で自動的に揃うわけではない。
    CI 側でも Corepack を有効にする手順が要る。

関連

バージョン固定の対象になるファイルは Lockfile、指定を書く場所は package.json である。
実際の症状は pnpm が command not found になる にまとめてある。