npmのキャッシュをクリアする方法をわかりやすく解説

npmを使っていると、Please run npm cache clean のようなエラーメッセージが表示されることがあります。これはnpmのキャッシュに問題が発生しているサインで、キャッシュのクリアや更新が必要な場合があります。

まずは以下のコマンドを実行して、キャッシュのクリアを試してみましょう。

npm cache clean

npmバージョン5以降の場合は「npm cache verify」を実行

ただし、npm v5以降ではキャッシュは自己修復機能を持つように設計されているため、npm cache clean を実行すると次のようなエラーが表示されることがあります。

npm ERR! As of [email protected], the npm cache self-heals from corruption issues and data extracted from the cache is guaranteed to be valid. If you want to make sure everything is consistent, use 'npm cache verify' instead.
npm ERR!
npm ERR! If you're sure you want to delete the entire cache, rerun this command with --force.

このエラーが表示された場合は、代わりに以下のコマンドを実行してください。整合性のチェックと修復を行ってくれます。

npm cache verify

それでも解決しない場合：node_modulesの削除と再インストール

npm cache verify でも問題が解決しない場合は、プロジェクト内の node_modules フォルダを削除し、再度 npm install を実行してみてください。依存関係の不整合によるエラーは、この方法で解消できることが多いです。

強制的にキャッシュを削除する「npm cache clean --force」

npm cache clean と npm cache verify のどちらでも解決せず、キャッシュをクリアできない場合は、強制オプションを付けて実行しましょう。

npm cache clean --force

または、短縮形の npm cache clean -f でも同じです。このコマンドを実行すると、PC上のnpmキャッシュが強制的に削除されます。

npm cache cleanとは何をしているのか？

npmでパッケージをインストールするとき、npmはまずパッケージとその依存関係をローカルのキャッシュフォルダに保存します。npm公式ドキュメントによると、この場所はPOSIX系（macOS・Linux）では ~/.npm、Windowsでは %AppData%/npm-cache です。

その後、npmはパッケージをプロジェクトの node_modules フォルダにインストールします。

一度キャッシュに保存されたパッケージは、次回同じパッケージをインストールする際に再ダウンロードされることなく、キャッシュから直接インストールされます。これにより、インストール時間の短縮やオフライン環境での作業が可能になります。

しかし、異なるバージョンの依存関係が混在して競合を起こすと、キャッシュが破損することがあります。そのような場合はキャッシュをクリアすることで、npmからパッケージを改めてダウンロードし、クリーンな状態でやり直すことができます。