ファイル監視

設定 / 環境設定ダイアログ Ctrl+Alt+S で、ツールのファイル監視をクリックします。ファイルウォッチャーページが開き、このプロジェクトと IDE ですでに構成されているファイル監視のリストが表示されます。

をクリックして、ファイル監視を作成したい定義済みテンプレートを選択します。選択は使用しようとしているツールに依存します。一覧にないツールを使用するには、カスタムを選択してください。新規ウォッチャーダイアログが開きます。

「名前」フィールドに、ファイル監視の名前を入力します。デフォルトでは、CLion は選択された定義済みテンプレートの名前を提案します。

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

既定では、このフィールドには選択した定義済みのテンプレートに従ってファイルの種類が表示されます。

ファイル監視が適用されるスコープを選択します。

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

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

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

• プロジェクトファイル : プロジェクトルート内のすべてのファイル。

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

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

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

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

詳細はスコープとファイルの色を参照してください。

オプション :FileWatcher で依存関係を処理する方法を指定します。ルートファイルは、指定されたスコープ内の他のファイルに（たとえば、import を介して）含まれていないファイルです。

• ファイルウォッチャーをルートファイルに対してのみ実行するには、ルートファイルのみを追跡するチェックボックスを選択します。

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

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

プログラムフィールドに、ツールの実行可能ファイルへのパス（.exe、.cmd、.bat、または特定のツールに応じてその他）を指定します。

引数フィールドで、ツールに渡す引数を定義します。

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

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

リフレッシュする出力パスフィールドで、ツールがその出力を保管するファイル（結果のソースコード、ソースマップ、依存関係）を指定します。これらの設定に基づいて、CLion はコンパイルによって生成されたファイルを認識します。

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

出力パスは通常、マクロを使用して指定されます。パスを手動で入力するか、 をクリックして、リストから関連するパターンを選択します。

作業ディレクトリと環境変数隠し領域を展開します。

環境変数を定義します。例: 構成しているツールの起動に必要ですが、そのパスで参照されていないツールの PATH 変数を指定します。ほとんどの場合、Node.js または ruby.exe です。このような状況は、Node パッケージマネージャー（npm）または gem マネージャーを介したインストールではなく、カスタムの手動インストールが原因である可能性があります。

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

ファイルウォッチャーを呼び出すイベントを指定します。

• ソースコードに変更が加えられたらすぐにファイルウォッチャーを呼び出すには、編集したファイルを自動保存してウォッチャーをトリガーするチェックボックスを選択します。
  チェックボックスをオフにすると、保存時（ファイル | すべて保存）または CLion からフォーカスを移動したとき（フレームの非アクティブ化時）にファイルウォッチャーが起動します。

• デフォルトでは、ファイル監視は、たとえばブランチをチェックアウトしたときにバージョン管理システムから受け取った更新を含め、保存された変更が発生すると起動します。このような変更を無視して、CLion でコードを更新するときにのみファイル監視を呼び出すには、外部の変更でウォッチャーをトリガーするチェックボックスをオフにします。

ファイルウォッチャーが CLion 構文解析プログラムと対話するかどうかを指定します。

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

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

stdout から出力ファイルを作成するチェックボックスを使用して、出力ファイルの生成方法を指定します。

• チェックボックスが選択されると、CLion はネイティブツールの出力 standard output stream (stdout) を読み込み、そこから結果ファイルを生成します。

• チェックボックスをオフにすると、ツールはその出力をリフレッシュする出力パスフィールドで指定されたファイルに直接書き込みます。

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

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

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

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