Corepack

概要

corepackは、Node.jsの公式ツールで、パッケージマネージャの管理を簡素化します。これにより、npmやYarnなどの複数のパッケージマネージャをプロジェクトごとに簡単に切り替え、管理できます。2024年にcorepackはNode.jsの標準添付ツールから外部パッケージとして分離され、別途インストールが必要になりました。

インストール方法

corepackは、npmまたはyarnを利用してインストールできます。

npmを使用してインストール

corepackをnpmを使ってグローバルにインストールするには、以下のコマンドを実行します。

npm install -g corepack

yarnを使用してインストール

yarnを使用してインストールする場合も、以下のコマンドを使用できます。

yarn global add corepack

インストール確認

corepackが正しくインストールされたか確認するには、次のコマンドを実行します。

corepack --version

これでインストールされているバージョンが表示されれば、インストールは成功しています。

基本的な使い方

パッケージマネージャの有効化

corepackは、npmやyarnなどのパッケージマネージャをプロジェクトで使用できるように管理します。使用したいパッケージマネージャを有効化するには、以下のコマンドを実行します。

corepack enable

このコマンドを実行することで、プロジェクトごとのパッケージマネージャのバージョンを管理できるようになります。

パッケージマネージャのインストール

特定のバージョンのnpmやyarnをインストールするには、corepackを利用して簡単にインストールできます。

corepack prepare npm@latest --activate

このコマンドは、最新のnpmバージョンをインストールし、プロジェクトで使用するために有効化します。

使用するパッケージマネージャの切り替え

異なるパッケージマネージャを使用する場合、corepackを使用して簡単に切り替えることができます。例えば、yarnを有効にするには以下のコマンドを実行します。

corepack prepare yarn@stable --activate

これで、プロジェクトでyarnを使用することができます。

設定ファイル

corepackの設定は、package.jsonのpackageManagerフィールドで行い、使用するパッケージマネージャやそのバージョンを指定することができます。

例

package.json

{
  "packageManager": "yarn@stable"
}

この設定を行うことで、corepackが指定されたパッケージマネージャを自動的に有効化します。

トラブルシューティング

corepackのインストールが失敗する

インストール中にエラーが発生した場合、まず以下のコマンドでキャッシュをクリアし、再試行してください。

npm cache clean --force

その後、再度corepackのインストールを試みます。

npm install -g corepack

パッケージマネージャのバージョンが正しく反映されない

corepackで使用するパッケージマネージャのバージョンが反映されない場合、以下のコマンドで手動でバージョンを指定して有効化してください。

corepack prepare npm@latest --activate

また、プロジェクトのpackage.jsonを確認して、設定が正しく記述されているか確認してください。

設定ファイルが無効な場合

package.jsonの設定が無効である場合、構文エラーや不正なバージョン指定が原因である可能性があります。設定ファイルを再度確認し、正しい形式で記述されていることを確認してください。

参考リンク

• corepack公式サイト
• corepack GitHub