# File Watchers

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

> **TL;DR**
> 必須プラグイン  ：
>
>
>
> `[ファイルウォッチャー](https://plugins.jetbrains.com/plugin/7177-file-watchers)`  -    設定 | プラグイン   ページでプラグインをインストールします。

File Watchers  を使用すると、IDE でファイルを変更または保存するときに、コンパイラー、フォーマッタ、リンターなどのコマンドラインツールを自動的に実行できます。

File Watchers には 2 つの専用  コードインスペクション があります。

* ファイル監視使用可能 インスペクションは、定義済みの File Watcher が適用可能なすべてのファイルで実行されます。 プロジェクトに関連するファイルウォッチャーが設定されていない場合、CLion は追加を提案します。

* ファイル監視問題 インスペクションは実行中の File Watcher によって呼び出され、それに固有のエラーをハイライトします。

利用可能なテンプレートの 1 つを使用するか、File Watcher を最初から構成することができます。 設定したファイル監視は、プロジェクト設定または IDE 設定に保存して、さまざまなプロジェクトで使用できます。

特定のツール用の File Watchers の詳細については、対応するページをご覧ください：

* [CSS の最小化 (CSSO オプティマイザー)](compressing-css.html)

* [Sass、Less、SCSS](transpiling-sass-less-and-scss-to-css.html#less_sass_scss_compiling_to_css)

* [Compass アプリケーションの Sass および SCSS](transpiling-compass-to-css.html#compass_compiling_sass_scss)

* [Stylus](transpiling-stylus-to-css.html#stylus_compilation)

* [CoffeeScript](coffeescript.html#ws_coffee_compilation)

CLion でこれらのツールの一部を利用するには、   設定 | プラグイン   ページで [JetBrains Marketplace からプラグインをインストールする](managing-plugins.html#install_plugin_from_repo)の説明に従い、プラグインをインストールする必要があることにご注意ください。

## 始める前に

[JetBrains Marketplace からプラグインをインストールする](managing-plugins.html#install_plugin_from_repo)の説明に従って、   設定 | プラグイン   ページで  File Watchers  プラグインをインストールして有効にします。

## File Watcher の作成

Procedure:

1. 設定   ダイアログ（ `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)) ）で、   ツール   の   File Watchers   をクリックします。 [File Watchers ページ](settings-tools-file-watchers.html)が開き、このプロジェクトと IDE ですでに構成されているファイルウォッチャーのリストが表示されます。

2. ![追加ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックし、File Watcher を作成するための定義済みテンプレートを選択します。 選択するテンプレートは、使用するツールによって異なります。 リストにないツールを使用する場合は、   カスタム   を選択してください。

![SCSS を CSS にコンパイルする: ファイルウォッチャーの作成](https://resources.jetbrains.com/help/img/idea/2026.3/ws_scss_example_create_file_watcher.png)

[新規ウォッチャー](new-watcher-dialog.html)ダイアログが開きます。

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

## 入力ファイルの予想されるタイプと場所の構成

ウォッチするファイル   領域のコントロールを使用して、ファイルウォッチャーを適用するファイルの範囲を定義します。

Procedure:

1. ファイルタイプ   リストから、予想される入力ファイルの種類を選択します。 File Watcher は、この種類のファイルのみを分析および処理の対象と見なします。 ファイルの種類は、 [ファイルタイプとファイル拡張機能の関連付け](creating-and-registering-file-types.html#register-new-association)に基づいて認識されます。

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

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

![SCSS ファイルウォッチャー: デフォルトのスコープを変更する](https://resources.jetbrains.com/help/img/idea/2026.3/ws_scss_example_file_watcher_settings_change_scope.png)

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

リストから定義済みスコープの 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) をクリックし、開いた  スコープ ダイアログで  カスタムスコープ を構成します。

詳細については、 [スコープとファイルの色](configuring-scopes-and-file-colors.html)を参照してください。

3. オプション : File Watcher が依存関係を処理する方法を指定します。  ルートファイル は、（例えば  `import`  経由で） [指定したスコープ内](new-watcher-dialog.html#scope)の他のファイルに含まれていないファイルです。

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

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

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

> **Note:**
> このオプションは、  Babel 、  Closure コンパイラー 、  Jade 、  Less 、  Sass /  SCSS 、  Stylus 、  UglifyJS (簡潔な)  でのみ使用できます。

## 外部ツールとの相互作用の構成

変更時に実行するツール   領域で、使用するツール、ツールに渡す引数、予想される出力ファイルの種類などを指定します。

Procedure:

1. プログラム   フィールドに、ツールの実行可能ファイルへのパス（  `.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)に追加してください。

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

引数は通常、実際のファイル名に置き換えられる  `$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"\` ）を使用します。

3. リフレッシュする出力パス   フィールドで、ツールがその出力を保管するファイル（結果のソースコード、ソースマップ、依存関係）を指定します。 これらの設定に基づいて、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:**
> リフレッシュする出力パス   フィールドの値を変更しても、ツールの出力が別の場所に保存されるわけではありません。 どうしても必要な場合は、   引数   フィールドに任意のカスタム出力先を指定してください。出力パスをコロンで区切り、マクロを使用します。

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

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

6. 作業ディレクトリ   フィールドに、ツールを適用するディレクトリを指定します。

ツールは常にファイルのコンテキストで呼び出されるため、デフォルトの作業ディレクトリは現在のファイルのディレクトリです。 デフォルトの作業ディレクトリは、  `$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 はファイルウォッチャーが起動されたファイルのディレクトリを使用します。

## 詳細オプションの構成

拡張オプション   領域では、File Watcher のデフォルト動作をカスタマイズします。

Procedure:

1. ファイルウォッチャーを呼び出すイベントを指定してください：

* ソースコードに変更が加えられたらすぐにファイルウォッチャーを呼び出すには、 編集したファイルを自動保存してウォッチャーをトリガーする チェックボックスを選択します。 チェックボックスをオフにすると、保存時（ `ファイル | すべて保存` ）または CLion からフォーカスを移動したとき（フレームの非アクティブ時）にファイルウォッチャーが起動します。 ![編集したファイルを自動保存オフ](https://resources.jetbrains.com/help/img/idea/2026.3/ws_scss_example_file_watcher_autosave_on_edit_off.png)

* デフォルトでは、File Watcher は、たとえばブランチをチェックアウトしたときにバージョンコントロールシステムから受信した更新など、保存された変更があると起動します。 このような変更を無視し、CLion でコードを更新したときのみファイルウォッチャーを呼び出すには、 外部の変更でウォッチャーをトリガーする チェックボックスをオフにします。

2. ファイルウォッチャーが CLion の構文パーサーと連携するかどうかを指定します：

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

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

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

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

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

4. コンソールの表示   リストで、File Watcher がいつコンソールを開くかを選択します。

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

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

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

## File Watcher によって報告された情報をエディターに表示する

ファイルウォッチャーで設定されたツールがコードに関するエラーや警告をファイルや特定の行へのリンク付きで通知した場合、この情報をエディターで直接確認できます：

* `設定 | エディター | インスペクション` では、インスペクション ファイルウォッチャーの問題 を有効にします。

* [ウォッチャーの編集](new-watcher-dialog.html)ダイアログの 出力フィルター フィールドで、照合したい出力の形式を記述してください。 そのためにマクロ `$FILE_PATH$` 、 `$LINE$` 、 `$MESSAGE$` を使用します。 `\` では、中括弧やドットなどの特別なシンボルを使用しないようにする必要があります。 `$MESSAGE$` マクロと一致するテキストがエディターに表示されます。

## ファイルウォッチャーの保存、有効化、無効化

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

新しい File Watcher を保存したら、現在のプロジェクト（   レベル   リストから   プロジェクト   を選択）でのみ使用可能にするか、すべてのプロジェクト（   グローバル   を選択）で使用可能にするかを決定できます。

![File Watcher を有効にする](https://resources.jetbrains.com/help/img/idea/2026.3/cl_enable_global_watcher.png)

Procedure:

* ファイルウォッチャーを有効または無効にするには、   設定   ダイアログ（ `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)) ）を開き、  `ツール | File Watchers`  に移動して、その横にあるチェックボックスをオンまたはオフにします。

* あらかじめ定義されたファイルウォッチャーが適用できるファイルを開くと、CLion はファイルウォッチャーの有効化を提案します：

![Less を CSS にコンパイルする: エディターのペインからファイルウォッチャーを作成する](https://resources.jetbrains.com/help/img/idea/2026.3/ws_less_example_create_file_watcher_from_pane.png)

* ファイルウォッチャーが有効化されている場合、選択したスコープ内の選択した型のファイルが変更または保存されると自動的に開始されます。 [詳細オプションの構成](#ws_filewatcher_advanced_options)を参照してください。

* ファイル監視の実行中にエラーが発生した場合、ファイル監視は自動的に無効になります。 ステータスを復元するには、ファイル監視を手動で有効にします。

Procedure: 新しいプロジェクトでグローバル File Watchers を有効にする

グローバル File Watchers は、今後作成するすべての新しいプロジェクトで自動的に有効にすることができます。

* 新規プロジェクトの設定   ダイアログ（  `ファイル | 新規プロジェクトの設定`  ）を開き、  `ツール | File Watchers`  に移動して、必要な File Watchers の横にあるチェックボックスを選択します。

* または、 [ようこそ画面](welcome-screen.html)で、   構成   リストから   設定   を選択します。 開いたダイアログで、関連する File Watcher の横にあるチェックボックスを選択します。

## File Watcher のトラブルシューティング

File Watcher が無効になっていることを通知するエラーメッセージを含むポップアップが表示される場合があります

考えられるエラーの一覧は以下の通りです：

|  報告された問題  |  問題説明  |  回避策  |
| --- | --- | --- |
|   `Unknown Scope error`   |  ファイルウォッチャーは、このプロジェクトで定義されていないスコープを使用します。  |  ウォッチャーをダブルクリックして、使用可能なスコープを選択するか、新しいスコープを作成します。  |
|   `Invalid executable`   |  このプロジェクトは、削除されたグローバル File Watcher を使用します。  |    削除   ボタン ![削除](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.remove.svg) を使用してウォッチャーをリストから削除するか、編集して同じ名前の新しいグローバルウォッチャーを作成します。  |
|     CLion は多数の同一ファイルウォッチャータスクを実行します     |     たとえば VCS からの一括更新後、CLion は保存されたファイルごとに個別のファイルウォッチャータスクを実行します。     |  ファイル固有のマクロ（例：  `&FileNameWithoutExtension&` ）を   引数   フィールドに追加し、 [外部ツールとの連携の設定](#transpilerBehaviour)を参照してください。  |

## See also

### マークアップ言語、スタイルシート

[CSS の最小化](compressing-css.html) [Sass、SCSS、Less、PostCSS](transpiling-sass-less-and-scss-to-css.html) [Compass アプリケーションの Sass および SCSS](transpiling-compass-to-css.html)

### 言語・フレームワーク別ガイドライン

[CoffeeScript](coffeescript.html)

### リファレンス

[File Watchers](settings-tools-file-watchers.html) [新規ウォッチャーダイアログ](new-watcher-dialog.html) [組み込みの IDE マクロ](built-in-macros.html)

### 外部リンク

[Working with Makefiles in CLion using Compilation DB and File Watchers](https://blog.jetbrains.com/clion/2018/08/working-with-makefiles-in-clion-using-compilation-db/)

