【解決方法】「gulp: command not found」エラーの原因と対処法

Gulpでタスクを実行している際、コマンドラインでgulpと入力したのに、gulp: command not foundというエラーが表示されて困ったことはありませんか？

なぜこのようなエラーが発生するのでしょうか。実は、どのディレクトリからでもコマンドラインでパッケージを実行できるようにするには、そのパッケージをPCにグローバル（全体）インストールしておく必要があるのです。

この記事では、この問題を解決するための方法を2つご紹介します。

方法1：gulp-cliをグローバルにインストールする

Gulpを実際に動かすには、次の2つの要素が必要です。

• Gulp CLIがグローバルにインストールされていること
• Gulp本体が、使用する各プロジェクトのディレクトリにローカルインストールされていること

そのため、プロジェクトディレクトリにGulpをインストールする前に、まずGulp CLIをグローバルにインストールしておきましょう。ターミナルまたはコマンドプロンプトで以下のコマンドを実行します。

npm install gulp-cli -g

Gulp CLIのインストールが完了したら、対象のプロジェクトディレクトリに移動し、次のコマンドでGulp本体をローカルにインストールします。

npm install gulp

これで、プロジェクト内でgulpコマンドが使えるようになるはずです。

方法2：npmのグローバルディレクトリ設定を確認する

Gulp CLIをグローバルにインストールしたのに、それでもエラーが出続ける場合はどうすればよいのでしょうか。

この場合、npmのグローバルディレクトリが誤った場所に設定されていることが原因の可能性があります。グローバルnpmディレクトリとは、パッケージをグローバルインストールした際にファイルが保存される場所のことです。

現在の設定場所は、コマンドラインで以下のコマンドを実行すると確認できます。

npm root -g

OSごとの正しいディレクトリ例

Windowsの場合：

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

Macの場合（正しい設定）：

/usr/local/lib/node_modules/

Macユーザーの方で、上記のコマンドの結果が/Users/ユーザー名/node_modulesのように返ってきた場合は、それがcommand not foundエラーの原因となっています。

設定を修正する方法

この問題を解決するには、以下のコマンドでnpmのプレフィックス（ルートフォルダ）設定を変更します。

npm config set prefix /usr/local

設定変更後、改めてGulp CLIのグローバルインストールとGulpのローカルインストールを行えば、エラーは解消されるはずです。