「gulpは内部または外部コマンドとして認識されません」エラーの解決方法

コマンドラインで gulp を実行したときに、次のようなエラーが表示されることがあります。

「'gulp' は、内部コマンドまたは外部コマンド、操作可能なプログラムまたはバッチ ファイルとして認識されていません。」

PowerShell を使用している場合は、次のようなメッセージが表示されます。

「用語 'gulp' は、コマンドレット、関数、スクリプト ファイル、または操作可能なプログラムの名前として認識されません。」

これらのエラーは、主に次の2つの原因が考えられます。

• Gulp CLI がコンピューターにグローバルにインストールされていない
• npm のグローバルディレクトリが Path 環境変数に登録されていない

以下の手順で順番に対処していきましょう。

Gulp CLI をグローバルにインストールする

Gulp をグローバルにインストールするには、まずコンピューターに Node.js がインストールされている必要があります。まだインストールしていない場合は、公式サイト NodeJS.org からダウンロードしてインストールしてください。

Node.js の準備ができたら、コマンドラインで次のコマンドを実行して、Gulp CLI をグローバルにインストールします。

npm install -g gulp-cli

インストールが完了したら、次のコマンドで正しくインストールされているか確認できます。

gulp --version

バージョン情報が表示されれば、Gulp CLI は正常に動作しています。

npm が Path 環境変数に追加されているか確認する

Gulp をグローバルにインストールしているのにエラーが解消しない場合は、npm のグローバルディレクトリが Path 環境変数に登録されていない可能性があります。特に Windows ではよくある原因です。

Windows での確認手順

1. スタートメニューを開き、「環境」と入力して検索します。
2. 表示された候補から「システム環境変数の編集」を選択します。
3. 「システムのプロパティ」ウィンドウが表示されるので、右下の「環境変数」ボタンをクリックします。
4. 新しいウィンドウが開いたら、「＜ユーザー名＞のユーザー環境変数」セクション（「ユーザー名」はご自身のアカウント名）にある「Path」をダブルクリック、または選択して「編集」をクリックします。

環境変数の一覧の中に、次のパスが含まれているか確認してください。

C:\Users\ユーザー名\AppData\Roaming\npm

もし存在しない場合は、「新規」ボタンをクリックして上記のパスを追加し、「OK」をクリックして保存します。

macOS / Linux の場合

Unix 系の OS では、シェルの設定ファイル（~/.bashrc や ~/.zshrc など）に以下の行が含まれているか確認してください。

export PATH=$PATH:/usr/local/bin

npm のグローバルインストール先は npm config get prefix コマンドで確認できるので、そのパスが PATH に含まれていなければ追記します。

最後に：CLI を再起動する

Path 環境変数の変更は、すでに開いているターミナルには反映されません。設定を保存したら、コマンドライン（CLI）を一度閉じて再起動してください。その後、再度 gulp --version を実行すれば、エラーが解消されて正常に動作するはずです。