ファイル監視

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

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

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

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

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

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

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

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

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

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

• スクラッチとコンソール : ファイルツールウィンドウ（表示 | ツールウィンドウ | ファイル）のすべてのスクラッチとコンソール。

• 最近表示したファイル : エディターで最近表示されたすべてのファイル。

• 最近変更したファイル : エディターで最近変更されたすべてのファイル。

• 新規モジュール : 現在のモジュール内のすべてのファイル。

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

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

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

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

詳細はスコープを参照してください。

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

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

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

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

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

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

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

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

環境変数を定義します。例：構成するツールの開始に必要なツールの PATH 変数を指定しますが、そのパスで参照されていません。

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

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

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

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

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

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

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

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

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

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

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

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

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

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