IntelliJ IDEA 2026.1 Help

Grunt

IntelliJ IDEA は Grunt JavaScript Task Runner(英語) と一体化しています。 IntelliJ IDEA は、タスクとターゲットの定義を認識し、ツリービューでタスクやターゲットを表示し、 Gruntfile.js ファイル内のタスクまたはターゲットと、タスクとターゲットの実行とデバッグをサポートする Gruntfile.js ファイルを解析します。

IntelliJ IDEAでは、専用の Grunt ツールウィンドウのタスクツリーから、 Grunt 実行構成を使用して、または起動前のタスクとして、Gruntタスクを実行できます。 IntelliJ IDEA は、 実行ツールウィンドウでタスクを実行した結果を示します。 ツールウィンドウには Grunt 出力が表示され、発生したエラーが報告され、見つからなかったパッケージまたはプラグインが一覧表示されます。 ツールウィンドウのタイトルバーには、最後に実行されたタスクの名前が表示されます。

始める前に

Node.js をダウンロードしてインストールします。

Grunt のインストール

IntelliJ IDEA プロジェクトで Grunt を使用するには、次の 2 つのパッケージが必要です。

  • Grunt コマンドを実行するためにグローバルにインストールされた grunt-cli パッケージ(Grunt コマンドラインインターフェース)。

  • プロジェクトのタスクツリーを構築し、 Gruntfile.js または Gruntfile.coffee ファイルの編集中に、コーディング支援を提供する開発依存関係としてインストールされた grunt パッケージ。 Gruntfile.js については、 Grunt official website で詳しく学ぶことができます。

grunt-cli をグローバルにインストールする

  • 組み込み ターミナル (Alt+F12) で次のように入力します。

    npm install -g grunt-cli

プロジェクトに Grunt をインストールする

  • 組み込み ターミナル (Alt+F12) で次のように入力します。

    npm install grunt --save-dev

タスクツリーから Grunt タスクを実行する

IntelliJ IDEA を使用すると、 Grunt ツールウィンドウのタスクツリーから Grunt タスクを簡単かつ迅速に実行できます。 IntelliJ IDEA は自動的に一時的な実行構成を作成し、必要に応じて保存して後で使用することができます。

Grunt ツールウィンドウを開く

IntelliJ IDEA セッション中に初めてタスクのツリーを構築するとき、 Grunt ツールウィンドウはまだ開かれていません。

  • プロジェクト ツールウィンドウ(Alt+1 )で必要な Gruntfile.js ファイルを選択するか、エディターで開いてコンテキストメニューから Grunt タスクの表示 を選択します。

Grunt ツールウィンドウからタスクのツリーを構築する

  1. Grunt ツールウィンドウで、ツールバーの 追加ボタン をクリックし、リストから必要な Gruntfile.js ファイルを選択します。 デフォルトでは、IntelliJ IDEA はプロジェクトのルートに Gruntfile.js ファイルを表示します。

  2. 別の Gruntfile.js ファイルがある場合は、 Gruntfile.js を選択 をクリックして表示されるダイアログで必要な Gruntfile.js ファイルを選択します。 IntelliJ IDEA は、タイトルに選択した Gruntfile.js ファイルへのパスを持つ新しいノードを追加し、新しいノードにタスクツリーを構築します。

ツリーを再構築する

  • 必要なノードに切り替えて、ツールバーの Reload Scripts をクリックします。

ツリー内のタスクを名前で並べ替える

  • ツールバーの 設定 をクリックし、メニューから 並べ替え を選択してから、 名前 を選択します。

    デフォルトでは、ツリーには、 Gruntfile.js (オプション 定義順序 )で定義されている順序でタスクが表示されます。

タスクまたはターゲットを実行する

  • タスクまたはターゲットをダブルクリックします。

  • ツリーでタスクまたはターゲットを選択して Enter を押すか、コンテキストメニューから <task name> の実行 を選択します。

タスクツリーからタスクを実行する場合、 強制実行詳細モードのオプションは使用できないことに注意してください。 その結果、たとえば、警告を無視したり、詳細なログを提供したりするように IntelliJ IDEA を構成することはできません。 これらのオプションを使用するには、以下の 実行構成に応じたタスクの実行とデバッグに従って、実行構成からタスクまたはターゲットを実行します。

デフォルトのタスクを実行する

  • ツリーのルートノードを選択し、選択したコンテキストメニューから デフォルトを実行 を選択します。

いくつかのタスクまたはターゲットを実行する

  • 複数選択モードを使用します:隣接するアイテムの場合は Shift 鍵を、隣接しないアイテムの場合は Ctrl 鍵を押しながら、必要なタスクやターゲットを選択し、選択した項目のコンテキストメニューから 実行 または デバッグ を選択します。

タスクまたはターゲットの定義に移動する

  • ツリーで必要なタスクまたはターゲットを選択して、選択のコンテキストメニューから ソースに移動 を選択します。

実行構成に応じたタスクの実行とデバッグ

タスクを実行するときに IntelliJ IDEA が自動的に作成する 一時的な実行構成を使用する以外に、独自の Grunt.js 実行構成を作成して起動できます。

Grunt.js の実行 / デバッグ構成を作成する

  1. 実行 | 実行構成の編集 に移動します。 または、ツールバーの 実行 ウィジェットから 実行構成の編集 を選択します。

    構成の編集を開くダイアログ

    開いた 実行構成の編集 ダイアログで、ツールバーの 追加 ボタン (追加ボタン) をクリックし、リストから Grunt.js を選択します。 実行 / デバッグ構成: Grunt.jsダイアログが開きます。

  2. 実行構成の名前、実行するタスク(区切り文字として空白スペースを使用)、これらのタスクが定義されている Gruntfile.js ファイルの場所、およびグローバルにインストールされた grunt-cli パッケージへのパスを指定します。

  3. 使用する Node.js ランタイムを指定します。

    プロジェクト エイリアスを選択すると、IntelliJ IDEA は JavaScript Runtime ページの Node runtime フィールドからプロジェクトの既定のインタープリターを自動で使用します。 ほとんどの場合、IntelliJ IDEA はプロジェクトの既定のランタイムを検出し、フィールド自体に入力します。

    別の構成済みのローカルインタープリターまたはリモートインタープリターを選択するか、 参照ボタン をクリックして新しいインタープリターを構成することもできます。

    必要に応じて、Node.js に渡す Node.js 固有のオプションパラメーター環境変数(英語)を指定します。

タスクを実行する

  • ツールバーの 実行 / デバッグ構成 ウィジェットリストから、新しく作成した 構成を選択し、その横にある 実行ボタン をクリックします。 IntelliJ IDEA は 実行ツールウィンドウにタスク出力を表示します。

タスクをデバッグする

  1. 上記のとおりGrunt.jsの実行/デバッグ構成を作成します。

  2. エディターで Gruntfile.js ファイルを開き、必要に応じてファイルに ブレークポイントを設定します。

  3. デバッグセッションを開始するには、メインツールバーのリストから必要なデバッグ構成を選択して、リストの横にある the Debug button をクリックするか、メインメニューから 実行 | デバッグ <remote_configuration_name> を選択します。

  4. 開いた デバッグツールウィンドウ で、 中断されたプログラムを調べる および プログラムのステップスルー に記載されているように、中断されたタスクの実行を解析したり、ステップスルーしたりします。

Grunt タスクを起動前タスクとして実行する

  1. メインメニューから 実行 | 実行構成の編集 を選択して 実行 / デバッグ構成ダイアログ ダイアログを開き、リストから必要な構成を選択するか、 追加ボタン をクリックして新たに作成し、関連する実行構成タイプを選択します。

  2. 開いたダイアログで、 起動前 エリアの 追加ボタン をクリックし、リストから Grunt タスクの実行 を選択します。

  3. 表示される Grunt タスク ダイアログで、必要なタスクが定義されている Gruntfile.js を指定し、実行するタスクを選択して、Grunt ツールに渡す引数を指定します。

    Node.js ランタイムのロケーション、渡すパラメーター、および grunt-cli パッケージへのパスを指定します。

Grunt タスクを自動的に実行する

定期的に実行するタスクまたはターゲットがある場合は、対応する実行構成を 起動タスクのリストに追加できます。 タスクはプロジェクトの起動時に自動的に実行されます。

  1. 設定 ダイアログ (Ctrl+Alt+S) で、 ツール | スタートアップタスク に進みます。

  2. 開いた 起動タスクページで、ツールバーの 追加ボタン をクリックします。

  3. リストから、必要な Grunt 実行構成を選択します。 設定がリストに追加されます。

    プロジェクトに適用可能な構成がない場合は、 the Add button` をクリックして 実行構成の編集 を選択します。 次に、開いた 実行 / デバッグ構成ページで必要な設定を使用して構成を定義します。 新しい設定を保存すると、自動的に起動タスクのリストに追加されます。

2026 年 3 月 30 日