新規ウォッチャーダイアログ

このリストを使用して、予想される入力ファイルのタイプを指定してください。ファイル監視機能は、このタイプのファイルのみを分析および処理の対象と見なします。ファイルタイプは、ファイルタイプとファイル拡張子の間の関連付けに基づいて認識されます。

このリストを使用して、ファイル監視を適用できるファイルの範囲を定義します。

これらのファイルを変更すると、編集したファイルを自動保存してウォッチャーをトリガーするチェックボックスの状態に応じて、直ちに、または保存またはフレームの非アクティブ化時にファイル監視が起動されます。

リストから定義済みスコープの 1 つを選択します。プロジェクトレベルのファイル監視の場合は、 をクリックして、表示されるスコープダイアログでカスタムスコープを設定することもできます。

• すべての場所 : 下記のすべての範囲

• プロジェクトファイル : プロジェクトコンテンツルート内のすべてのファイル（コンテンツルートを参照）。

• プロジェクト製品ファイル : テストソースを除くプロジェクトコンテンツルート内のすべてのファイル。

• プロジェクトテストファイル : プロジェクト内のすべてのファイルがテストソースのルートになります。

• スクラッチとコンソール : プロジェクトツールウィンドウにあるスクラッチとコンソールディレクトリからのすべてのファイル。

• 開いているファイル : 現在エディターで開かれているすべてのファイル。

• 現在のファイル : アクティブなエディタータブで開かれたファイル

VCS スコープ : これらのスコープは、プロジェクトがバージョン管理されている場合にのみ使用できます。

• すべての変更ファイル : すべての変更されたファイル、つまりすべての既存の変更リストに関連付けられたすべてのファイル。

• デフォルト変更リスト : 変更リスト Default に関連付けられているすべてのファイル。

または、 をクリックし、開いたスコープダイアログでカスタムスコープを構成します。

• このチェックボックスをオンにすると、ファイルウォッチャーはルートファイルに対してのみ実行されます。

• チェックボックスをオフにすると、ファイル監視はファイルウォッチャーが呼び出されたファイルに対して実行され、このファイルが指定されたスコープ内に再帰的に含まれるすべてのファイルに対して実行されます。

スコープ設定はルートファイルのみを追跡するチェックボックスの設定よりも優先されることに注意してください。依存関係が指定されたスコープの外にある場合、ファイルウォッチャーはそれに適用されません。

例
root.scss が another.scss をインポートする 2 つのファイル root.scss と another.scss があるとします。ルートファイルのみを追跡するチェックボックスを選択した状態で、another.scss を編集すると、root.scss でのみファイルウォッチャーが呼び出されます。それ以外の場合、チェックボックスがオフになっていると、ファイルウォッチャーはこれらのファイルの両方を処理します。

このフィールドには、ツールの実行可能ファイルへのパスを指定します。( .com、.exe、.cmd、.bat または特定のツールに応じたその他。)

このフィールドでは、ツールに渡す引数を定義してツールの動作に影響を与えます。

引数は通常マクロを使用して指定されます。たとえば、$FileName$ や $FileNameWithoutExtension$ は実際のファイル名に置き換えられます。

マクロを手動で入力するか、 をクリックして、開いたマクロダイアログのリストから関連するパターンを選択します。

このフィールドで、IntelliJ IDEA にツールの出力を検索する場所（結果のソースコード、ソースマップ、依存関係、またはファイル自体）を指定します。出力の場所はツールによって異なります。

出力パスは通常、マクロを使用して指定されます。手動で入力するか、 をクリックして、開いたダイアログのリストから関連するものを選択できます。

リフレッシュする出力パスフィールドの値を変更しても、ツールはその出力を別の場所に保存しません。それでもそれを行う必要がある場合は、引数フィールドに希望のカスタム出力位置を指定します。コロンとしてコロンを使用して出力パスを区切り文字として入力し、マクロを使用します。

このフィールドでは、ツールを適用するディレクトリを指定します。ツールは常にファイルのコンテキストで呼び出されるため、デフォルトの作業ディレクトリは現在のファイルのディレクトリです。デフォルトの作業ディレクトリは、$FileDir$ マクロを通じてすべての事前定義テンプレートで指定されています。カスタム作業ディレクトリを指定するには、フィールドへのパスを入力するか、 をクリックしてパスの選択ダイアログでディレクトリを選択するか、 をクリックしてマクロダイアログのリストから目的のマクロを選択します。

• このチェックボックスをオンにすると、ファイルウォッチャーがすぐに起動するように IntelliJ IDEA はファイルを編集するとすぐにファイルを保存します。

• チェックボックスをオフにすると、ファイルウォッチャーは保存（ファイル | すべて保存）または IntelliJ IDEA（フレーム非アクティブ化時）からフォーカスを移動すると開始します。

• このチェックボックスをオンにすると、IntelliJ IDEA 以外の変更や、バージョン管理システムのブランチをチェックアウトした後の変更を含め、ファイルウォッチャーがそのスコープからファイルを変更したときに起動します。

• チェックボックスをオフにすると、スコープのファイルが IntelliJ IDEA から更新され、バージョン管理システムから受け取った変更などの他の変更は無視されます。

• チェックボックスをオンにすると、ファイル監視はファイルの構文上の正確さに関係なく起動します。ファイルウォッチャーは、編集したファイルを自動保存してウォッチャーをトリガーするチェックボックスの状態に応じて、更新、保存、またはフレームの非アクティブ化時に開始されます。

• このチェックボックスをオフにすると、ファイル監視は構文上無効なファイル内のすべてのトリガーを無視し、エラーのないファイルでのみ起動します。

• ほとんどの場合、このチェックボックスは、ほとんどのツールが関連するファイルに直接出力を書き込むため、クリアする必要があります。

• このチェックボックスを選択すると、IntelliJ IDEA はネイティブツールの出力 standard output stream (stdout) を読み込み、そこから結果ファイルを生成します。生成されたファイルの名前はリフレッシュする出力パスフィールドから取られます。フィールドに複数の名前が含まれている場合は、リストの最初の名前が使用されます。

このリストから、ファイル監視がいつコンソールを開くかを選択します。

• 常に: このオプションを使用すると、ツールの実行が完了した後、コンソールが常に開きます。

• エラー時 : このオプションを使用すると、Exit code が 0 と異なる場合にのみツール実行後にコンソールが開きます。

• しない: コンソールをまったく開かないようにするには、このオプションを選択します。

このフィールドでは、ツールに関連付けられた出力フィルターを指定します。これらのフィルターに基づいて、ツールの出力の絶対ファイルパスと行番号がハイパーリンクに変換されます。これらのリンクをクリックすると、対応するファイルがエディターで開きます。
例: 有用なエラーメッセージを表示するには、$FILE_PATH$:$LINE$ $MESSAGE$ と入力します