Node.js モジュール削除方法

Node.js で npm モジュールをアンインストールする方法

Node.js のプロジェクトで不要になった npm モジュールを削除するには、npm uninstall コマンドを使用します。このコマンドにはいくつかのオプションがあり、削除方法によって使い分けます。

基本的なアンインストール

プロジェクト内の node_modules フォルダからモジュールを削除するには、以下のコマンドを使います。

npm uninstall <モジュール名>

例えば、express モジュールを削除する場合は、次のようにします。

npm uninstall express

このコマンドは、package.json ファイルには影響を与えません。

package.json からも削除する

package.json ファイルからモジュールを削除し、依存関係から外すには、次のオプションを使います。

npm uninstall --save <モジュール名>

または、開発用依存関係として登録されている場合は、

npm uninstall --save-dev <モジュール名>

グローバルにインストールされたモジュールのアンインストール

グローバルにインストールされたモジュールを削除するには、-g オプションを付けます。

npm uninstall -g <モジュール名>

注意点

• package.json ファイルを手動で編集してモジュールを削除することも可能ですが、誤って削除しないよう注意が必要です。
• アンインストール後に node_modules フォルダを完全に削除して、再インストールすることもできますが、通常は必要ありません。

• npm uninstall * は、すべてのモジュールを削除しますので注意してください。
• 一度に複数のモジュールをアンインストールするには、スペースで区切ってモジュール名を指定します。
• npm uninstall コマンドは、指定したモジュールとその依存関係を削除します。

日本語での解説
 

Node.js のプロジェクトで npm モジュールをアンインストールするには、npm uninstall コマンドを使います。基本的には npm uninstall <モジュール名> で削除できますが、package.json からも削除したい場合は --save や --save-dev オプションを使います。グローバルにインストールされたモジュールを削除する場合は -g オプションを使います。注意点は、一度にすべてのモジュールを削除しないようにすることと、package.json ファイルを手動で編集しないことです。

npm uninstall express

• 上記のコマンドは、プロジェクト内の node_modules フォルダから express モジュールを削除します。

npm uninstall --save lodash

• 上記のコマンドは、プロジェクト内の node_modules フォルダから lodash モジュールを削除し、同時に package.json ファイルから依存関係として削除します。

npm uninstall -g typescript

• 上記のコマンドは、グローバルにインストールされた typescript モジュールを削除します。

一度に複数のモジュールをアンインストール

npm uninstall react react-dom

• 上記のコマンドは、react と react-dom の両方をアンインストールします。

すべてのモジュールを削除（注意：通常は使用しない）

npm uninstall *

• 上記のコマンドは、プロジェクト内のすべてのモジュールを削除します。誤って実行しないように注意してください。

• npm uninstall <モジュール名1> <モジュール名2> ...: 一度に複数のモジュールをアンインストール
• npm uninstall -g <モジュール名>: グローバルにインストールされたモジュールのアンインストール
• npm uninstall --save <モジュール名>: package.json からも削除
• npm uninstall <モジュール名>: 基本的なアンインストール

注意

• node_modules フォルダは通常、Git で管理しないため、.gitignore ファイルに含めることを推奨します。
• 上記のコマンドはターミナルやコマンドプロンプトで実行します。

手動削除

• package.json 編集
  package.json ファイルからモジュールを削除し、その後 npm install を実行することで、モジュールを削除できます。ただし、手動編集はミスが発生しやすいため、注意が必要です。
• 直接削除
  node_modules フォルダ内のモジュールフォルダを直接削除できます。しかし、依存関係が複雑な場合、問題が発生する可能性があります。

npm 関連コマンド

• npx depcheck
  使用されていない依存関係を検出します。
• npm dedupe
  重複する依存関係を削減します。
• npm prune
  不要な依存関係を削除します。

• スクリプトの作成
  複数のモジュールを削除する必要がある場合、スクリプトを作成して自動化できます。
• パッケージマネージャーの利用
  Yarn や pnpm などの他のパッケージマネージャーを使用すると、異なるアンインストール方法がある場合があります。

• パッケージマネージャーによってコマンドやオプションが異なる場合があります。
• npm prune や npm dedupe は、不要なモジュールを削除するのではなく、依存関係を最適化するためのコマンドです。
• 手動削除や package.json 編集は、依存関係の複雑さに影響を与える可能性があります。

具体的な例

• npm dedupe
  

  npm dedupe
  

• npm prune
  

  npm prune
  

• package.json 編集
  

  // package.json
  "dependencies": {
    // "express": "^4.18.2" を削除
  }
  

  その後、npm install を実行します。

• rm -rf node_modules/express
  

  ただし、この方法は推奨されません。

npm uninstall コマンドが一般的に使用されますが、状況に応じて他の方法も検討できます。手動削除や package.json 編集はリスクが高いため、慎重に使用してください。npm prune や npm dedupe は依存関係の最適化に役立ちます。