グローバルインストール vs ローカルインストール：混乱しないためのルールと実践例

グローバルインストールとローカルインストールの違いとは？

npm install には2つの主要な使い方があります。

グローバルインストール（-g オプション付き）

npm install -g eslint

• 特徴：どのプロジェクトからでも使えるように、OS全体にインストールされます。
• 用途：コマンドラインツールやCLI系のユーティリティ（例：eslint、vite、npm-check-updates）など、どこからでも呼び出す必要があるものに最適。

ローカルインストール（カレントディレクトリに）

npm install eslint --save-dev

• 特徴：プロジェクトの node_modules フォルダにのみインストールされます。
• 用途：そのプロジェクト内だけで使用するライブラリや開発ツールに使用（例：react、tailwindcss、webpackなど）。

どちらを使うべき？判断ルール4つ

1. CLIツールかどうか？
   • ✅ CLIツール（例：eslint） → グローバルでもOK（ただし後述の理由でローカル推奨）
   • ✅ ライブラリ（例：lodash、axios） → ローカル一択
2. プロジェクトごとにバージョンを管理したいか？
   • ✔ プロジェクト依存のバージョンを固定したいならローカル
   • ❌ グローバルにすると他のプロジェクトとバージョン競合が起きやすい
3. CI/CDやチーム開発で使うか？
   • ✅ 再現性が必要 → ローカル
   • グローバル依存はGitに残らないためチーム開発では非推奨
4. npxで代替できるか？
   • npx eslint のように、一時的にパッケージを実行できるため、グローバルインストールせずに済むことも多い

実践例：eslintを使った違いの比較

パターン① グローバルインストール

npm install -g eslint
eslint src/index.js

• ❌ 他の人の環境にeslintが入っていないと動かない
• ❌ プロジェクトにeslintのバージョン情報が残らない

パターン② ローカルインストール＋npx

npm install --save-dev eslint
npx eslint src/index.js

• ✅ package.json に記録され、再現性が高い
• ✅ CI/CDでも動作保証される

注意点：同名コマンドの競合に注意

たとえば、グローバルとローカルの両方に eslint を入れていると、どちらのバージョンが使われるかは以下のような順序になります：

1. node_modules/.bin/eslint
2. 環境変数 PATH に登録されているグローバルの eslint

解決策としては、**常にnpx eslint**と書くようにしておくと、ローカル版が優先されます。

まとめ１：グローバル vs ローカルの使い分けルール

• ✅ CLIツールでもできるだけローカルにして、npxで実行するのが基本
• ✅ チーム開発・CI/CDではローカル以外はNG
• ✅ グローバルは、個人でよく使うCLIツールだけにとどめよう

明確なルールを持つことで、環境依存のトラブルを防ぎ、プロジェクトの再現性・保守性を高めることができます。

まとめ２：グローバルとローカルの違いを理解してトラブルを防ごう

npmのインストール方式を正しく使い分けることで、開発効率とプロジェクトの安定性が大きく変わります。「なぜ動かない？」を防ぐためにも、原則はローカルインストール＆npx実行。これを基本に据えておけば、今後のプロジェクト管理も格段にスムーズになります。