【Gulp】「Local gulp not found」エラーの原因と解決方法をわかりやすく解説

コマンドラインでGulpを実行しようとした際に、「Local gulp not found」というエラーメッセージが表示されて困っていませんか？

このエラーは、Gulpをグローバルにインストールしていても発生します。Gulpを使用したい各プロジェクトのディレクトリごとに、ローカルへのインストールが必要だからです。

この記事では、エラーの具体的な解決方法と、グローバル・ローカル両方のインストールが必要な理由について詳しく解説します。

「Local gulp not found」エラーの解決方法

まず、ターミナル（コマンドライン）で対象のプロジェクトディレクトリに移動し、以下のコマンドを実行してGulpをローカルにインストールしましょう。

npm install gulp

または、Gulpを開発依存パッケージ（devDependency）としてpackage.jsonファイルに記録したい場合は、次のコマンドを使用します。

npm install gulp --save-dev

これでプロジェクト内にGulpがインストールされ、「Local gulp not found」エラーは解消されるはずです。

なぜGulpはグローバルとローカル両方にインストールが必要なのか？

Gulpをグローバルにもローカルにもインストールしなければならないのは、一見ややこしく感じるかもしれません。「一度インストールすれば済むのでは？」と思う方も多いでしょう。

しかし、それぞれのインストールには明確な役割があります。

グローバルにインストールするのは「Gulp CLI」

グローバルにインストールが必要なのは、Gulp CLI（コマンドラインインターフェース）です。これにより、PC上のどのディレクトリからでも、コマンドラインでgulpコマンドを入力・実行できるようになります。

ローカルにインストールするのは「Gulp本体」

一方、各プロジェクトディレクトリでは、他のnpmパッケージと同じように、Gulp本体をローカルパッケージとしてインストールする必要があります。ローカルのGulpがあれば、そのプロジェクト用に設定したgulpfile.jsや、すべてのGulpタスク・関数を実行できるのです。

バージョンを使い分けるための仕組み

グローバルのGulp CLIとローカルのGulpを併用する最大の理由は、プロジェクトごとに異なるバージョンのGulpを使い分けられる点にあります。

Gulp CLIは、Gulp v4のリリース時に導入されました。開発者がプロジェクトに応じてGulp v3とGulp v4のどちらでも実行できるようにするためです。

Gulp CLIが登場する以前は、Gulp本体をPCにグローバルにインストールするのが一般的でした。しかし、その場合、PC上のすべてのプロジェクトで使用できるGulpのバージョンは1つだけに限られてしまい、非常に不便でした。

まとめ

「Local gulp not found」エラーは、プロジェクトディレクトリにGulpがローカルインストールされていないことが原因です。npm install gulp --save-devを実行すれば簡単に解決できます。グローバルのGulp CLIとローカルのGulpは役割が異なるため、両方のインストールを正しく行いましょう。