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 になる にまとめてある。