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

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/ja-jp/help/clion/llms.txt).

> **TL;DR**
> `ファイル | 設定 | ツール | File Watchers - 新規ウォッチャー`  (Windows および Linux 用)
>
>
>
> `%instance% | 設定 | ツール | File Watchers - 新規ウォッチャー`  (macOS 用)
>
>
>
> `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) ![設定アイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.settings.svg)

> **Note: 前提条件**
> File Watchers   プラグインを [インストール](managing-plugins.html#install_plugin_from_repo)して有効にします。

> **Warning:**
> セーフモード でプロジェクトを開いたときに、ファイルウォッチャーは起動しません。 詳細については、 [プロジェクトのセキュリティ](project-security.html) を参照してください。

[File Watchers ページ](settings-tools-file-watchers.html)の   追加    ![追加ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) または   編集    ![the Edit button](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.edit.svg)ボタンをクリックすると、ダイアログが開きます。 このダイアログを使用して、定義済み CLion ファイルウォッチャーテンプレートに基づいてプロジェクトファイルウォッチャーを作成、または既存のプロジェクトファイルウォッチャーを編集します。

各テンプレートには、選択したツールに最適な設定が含まれています。 ほとんどの場合、必要なのは、ツールの実行可能ファイルへのパスを指定することだけです。

## 命名方法名

命名方法名   フィールドに、File Watcher の名前を入力します。 デフォルトで、CLion は選択した定義済みテンプレートの名前を提案します。

## ウォッチするファイル

|  ファイルタイプ  |     このリストを使用して、予想される入力ファイルの種類を指定します。 File Watcher は、この種類のファイルのみを分析および処理の対象と見なします。 ファイルの種類は、 [ファイルの種類とファイル拡張子の関連](creating-and-registering-file-types.html#register-new-association)付けに基づいて認識されます。      > **Tip:** > デフォルトで、このフィールドには選択した定義済みテンプレートに従ってファイルタイプが表示されます。    |
|  スコープ  |     このリストを使って、ファイルウォッチャーを適用できるファイルの範囲を定義します。       これらのファイルを変更すると、   編集したファイルを自動保存してウォッチャーをトリガーする   チェックボックスの状態に応じて、直ちに、または保存またはフレームの非アクティブ化時にファイル監視が起動されます。       リストから定義済みスコープの 1 つを選択します。 プロジェクトレベルのファイル監視の場合は、 ![参照ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg) をクリックして、表示される   スコープ   ダイアログでカスタムスコープを設定することもできます。        * すべての場所： : 下記のすべての範囲    * プロジェクトファイル： : プロジェクトルート内のすべてのファイル。    * スクラッチとコンソール： : プロジェクト ツールウィンドウにある スクラッチとコンソール ディレクトリからのすべてのファイル。    * 開いているファイル： : 現在エディターで開かれているすべてのファイル。    * 現在のファイル： : アクティブなエディタータブで開かれたファイル      または、 ![参照ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg) をクリックし、開いた  スコープ ダイアログで  カスタムスコープ を構成します。      > **Tip:** > 詳細については、 [スコープとファイルの色](configuring-scopes-and-file-colors.html)を参照してください。    |
|  ルートファイルのみトラックする  |   ルートファイル とは、他のファイル [指定されたスコープ内](#scope)に（例：  `import` で）含まれていないファイルです。     * このチェックボックスをオンにすると、File Watcher は ルートファイル に対してのみ実行されます。    * チェックボックスをオフにすると、File Watcher はファイルウォッチャーが呼び出されたファイルに対して実行され、このファイルが指定されたスコープ内に再帰的に含まれるすべてのファイルに対して実行されます。        スコープ   設定は   ルートファイルのみトラックする   チェックボックスの設定よりも優先されることに注意してください。依存関係が指定された範囲の外にある場合、ファイルウォッチャーはそれに適用されません。        例 2 つのファイル  `root.scss`  と  `another.scss`  があり、  `root.scss`  が  `another.scss`  をインポートしているとします。   ルートファイルのみトラックする   チェックボックスをオンにすると、  `another.scss`  を編集すると、  `root.scss`  でのみ File Watcher が呼び出されます。 チェックボックスをオフにすると、File Watcher はこれらの両方のファイルを処理します。      > **Tip:** > このオプションは、  Babel 、  Closure コンパイラー 、  Jade 、  Less 、  Sass /  SCSS 、  Stylus 、  UglifyJS (簡潔な)  でのみ使用できます。    |

## 変更時に実行するツール

この領域では、ツールとの対話を設定します。使用する実行可能ファイル、渡す引数、および CLion がツールの出力を探す場所を指定します。

|  プログラム  |     このフィールドでは、ツールの実行可能ファイルへのパスを指定します（  `.com` 、  `.exe` 、  `.cmd` 、  `.bat` 、または特定のツールに応じてその他）。      > **Tip:** > * ファイル名のパスの代わりにプログラムのファイル名を使用するには、そのフォルダーへのパスをシステム環境変数 PATH に追加します。 > > * Windows では、 `.com` 、 `.exe` 、 `.cmd` または `.bat` 拡張子をスキップできます。 > > * `jar` アーカイブを使用するには、その絶対パスを指定します。 または、相対パスを使用する場合は、 外観 & 振る舞い \| パス変数 設定ページ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))で、その親フォルダーを [CLion パス変数](absolute-path-variables.html)に追加してください。    |
|  引数  |     このフィールドでは、ツールに渡す引数を定義してツールの動作に影響を与えます。       引数は通常、実際のファイル名に置き換えられる  `$FileName$`  や  `$FileNameWithoutExtension$`  などの [マクロ](built-in-macros.html)を使用して指定されます。       マクロを手動で入力するか、 ![the Insert Macros アイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.inlineAddHover.svg) をクリックして、開いた   マクロ   ダイアログのリストから関連するパターンを選択します。      > **Tip:** > 引数を指定するときは、次のルールに従ってください： > > * セパレータとしてスペースを使用します。 > > * 引数に空白が含まれている場合は、引数または引数全体を二重引用符で囲みます（ `some" "arg` または `"some arg"` ）。 > > * 引数に二重引用符が含まれている場合は、エスケープするためにバックスラッシュ（ `-Dmy.prop=\"quoted_value"\` ）を使用します。    |
|  リフレッシュする出力パス  |     このフィールドで、CLion にツールの出力：結果のソースコード、ソースマップ、依存関係、またはファイル自体を検索する場所を指定します。 出力の場所はツールによって異なります。       通常、出力パスは [マクロ](built-in-macros.html)を使用して指定されます。 手動で入力するか、 ![the Insert Macros アイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.inlineAddHover.svg) をクリックして、開いたダイアログのリストから関連するものを選択できます。       複数のマクロを指定するには、区切り文字としてコロン  `:`  を使用します (例:  `$FileNameWithoutExtension$.css:$FileNameWithoutExtension$.css.map`  )。         > **Note:** > リフレッシュする出力パス   フィールドの値を変更しても、ツールの出力が別の場所に保存されるわけではありません。 どうしても必要な場合は、   引数   フィールドに任意のカスタム出力先を指定してください。出力パスをコロンで区切り、マクロを使用します。       |

## 作業ディレクトリと環境変数

|  作業ディレクトリ  |     このフィールドでは、ツールが適用されるディレクトリを指定します。 ツールは常にファイルのコンテキストで呼び出されるため、デフォルトの作業ディレクトリは現在のファイルのディレクトリです。 デフォルトの作業ディレクトリは、  `$FileDir$`  マクロを使用してすべての定義済みテンプレートで指定されます。 カスタム作業ディレクトリを指定するには、そのパスをフィールドに入力するか、 ![閲覧アイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.openDiskHover.svg) をクリックして   パスの選択   ダイアログでディレクトリを選択、または ![the Insert Macros アイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.inlineAddHover.svg) をクリックして   マクロ   ダイアログ内のリストから目的の [マクロ](built-in-macros.html)を選択してください。      > **Tip:** > 作業ディレクトリ   フィールドを空にすると、CLion はファイルウォッチャーが起動されたファイルのディレクトリを使用します。    |
|  環境変数  |  このフィールドには、ツールが必要とするがオペレーティングシステムレベルでは指定されていない環境変数を指定します。  |

## 拡張オプション

|  編集したファイルを自動保存してウォッチャーをトリガーする  |      * このチェックボックスを選択すると、CLion はファイルを編集した瞬間にすぐ保存し、ファイルウォッチャーが即時に起動します。    * チェックボックスをオフにすると、保存時（ `ファイル \| すべて保存` ）または CLion からフォーカスを移動したとき（フレームの非アクティブ時）にファイルウォッチャーが起動します。    |
|  外部の変更でウォッチャーをトリガーする  |      * このチェックボックスを選択すると、CLion 外での変更やバージョン管理システムでブランチをチェックアウトした後の変更なども含め、そのスコープ内のファイルへのあらゆる変更でファイルウォッチャーが起動します。    * チェックボックスをオフにすると、ファイルウォッチャーはそのスコープ内のファイルが CLion から更新されたときのみ起動し、たとえばバージョン管理システムから受信した変更などほかの変更は無視されます。    |
|  構文エラーに関係なくウォッチャーをトリガーする  |      * チェックボックスをオンにすると、File Watcher はファイルの構文上の正確さに関係なく起動します。 ファイルウォッチャーは、 編集したファイルを自動保存してウォッチャーをトリガーする チェックボックスの状態に応じて、更新、保存、フレームの非アクティブ化時に開始されます。    * このチェックボックスをオフにすると、File Watcher は構文上無効なファイル内のすべてのトリガーを無視し、エラーのないファイルでのみ起動します。    |
|  stdout から出力ファイルを作成する  |      * ほとんどの場合、このチェックボックスは、ほとんどのツールが関連するファイルに直接出力を書き込むため、クリアする必要があります。    * このチェックボックスを選択すると、CLion はネイティブツールの出力 `standard output stream (stdout)` を読み込んでそこから結果ファイルを生成します。 生成されたファイルの名前は リフレッシュする出力パス フィールドから取られます。 フィールドに複数の名前が含まれている場合は、リストの最初の名前が使用されます。    |
|  コンソールの表示  |     このリストから、ファイルウォッチャーをいつコンソールで開くかを選択してください。        * 常時： : このオプションを使用すると、ツールの実行が完了した後にコンソールが常に開きます。    * エラー時： : このオプションを使用すると、 `Exit code` が `0` と異なる場合にのみツール実行後にコンソールが開きます。    * なし： : コンソールをまったく開かないようにするには、このオプションを選択します。    |
|  出力フィルター  |     このフィールドで、ツールに関連付けられている出力フィルターを指定します。 これらのフィルターに基づいて、ツールの出力の絶対ファイルパスと行番号がハイパーリンクに変換されます。 これらのリンクをクリックすると、対応するファイルがエディターで開きます。    例: 有用なエラーメッセージを表示するには、  `$FILE_PATH$:$LINE$ $MESSAGE$`  と入力します        |

## See also

### プロシージャ

[File Watchers](using-file-watchers.html)

### リファレンス

[File Watchers](settings-tools-file-watchers.html)

