# File Watchers

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/idea/llms.txt).

> **TL;DR**
> `文件 | 设置 | 工具 | 文件监视器`  适用于 Windows 和 Linux
>
>
>
> `%instance% | 设置 | 工具 | 文件监听器`  适用于 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)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (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: 前提**
> [安装](managing-plugins.html#install_plugin_from_repo)并启用   File Watchers   插件。

当  File Watchers  插件启用时，该页面可用。 有关配置 File Watchers 的更多信息，请参阅 [File Watchers](using-file-watchers.html)。  File Watchers  插件未 与 IntelliJ IDEA 捆绑，但可以在   设置 | 插件   页面上安装，如 [从 JetBrains Marketplace 安装插件](managing-plugins.html#install_plugin_from_repo)中所述。

File Watcher  是一个 一个 IntelliJ IDEA 系统，它跟踪文件的变化并运行第三方独立应用程序。 IntelliJ IDEA 提供了一些标准最受欢迎的的第三方工具（ [编译器](http://en.wikipedia.org/wiki/Source-to-source_compiler)、压缩器、美化器等）的预定义文件监视器模板。

您还可以配置自定义 File Watcher 以运行其他任何第三方工具。

> **Warning:**
> 在  安全模式 下打开项目时，File Watchers 不会启动。 更多信息请参阅 [项目安全](project-security.html)。

文件监视器有两个专用的  代码检查 ：

* 文件关注者可用 检查会在每个适用预定义文件关注者的文件中运行。 如果项目未配置相关的文件关注者，IntelliJ IDEA 会建议添加一个。

* 文件关注者问题 检查由正在运行的文件关注者调用，并高亮显示其特定错误。

该页面包含可用 File Watcher 的列表和用于管理此列表的工具栏。

对于每个 File Watcher，您可以决定它是仅在当前项目中可用（从   项目   的   级别   列表中选择）还是在所有项目中可用（选择   全局  ）。

要激活  File Watcher ，请勾选旁边的复选框。 当 File Watcher 启用时，只要所选类型和选定范围内的文件更改或保存，它就会自动启动，请参阅 [配置高级选项](using-file-watchers.html#ws_filewatcher_advanced_options)。 如果文件关注者运行时发生错误，该文件关注者会被自动禁用。 若要恢复状态，请手动启用 File Watcher。

|  条目  |  工具提示和快捷键  |  描述  |
| --- | --- | --- |
|  !["添加"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)  |  添加 `Alt+Insert` (Windows), `⌘ N` (macOS), `⌃ N` (IntelliJ IDEA Classic (macOS)), `⌘ N` (macOS System Shortcuts), `Alt+Insert` (XWin), `Alt+Insert` (GNOME), `Alt+Insert` (KDE), `Alt+Insert` (Emacs), `Ctrl+N` (Sublime Text), `⌘ N` (Sublime Text (macOS)), `Ctrl+N` (Visual Studio), `⌘ N` (Visual Studio (macOS)), `Alt+Insert` (NetBeans), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS))  |  点击这个按钮以打开   选择模板  弹窗并选择相应的  File Watcher 类型。 之后，IntelliJ IDEA 将打开  [New Watcher](new-watcher-dialog.html) 对话框，以根据当前项目的设置自定义预定义的  File Watcher 。  |
|  ![编辑按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.edit.svg)  |  编辑 `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS))  |  点击此按钮以在 [编辑 Watcher](new-watcher-dialog.html) 对话框中更新所选  File Watcher  的设置。 更新只应用于当前项目的  File Watcher ，不会影响预定义的 IntelliJ IDEA 级别模板。  |
|  !["移除"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.remove.svg)  |  移除 `Alt+Delete` (Windows), `⌘ ⌦` (macOS), `⌘ ⌦` (IntelliJ IDEA Classic (macOS)), `⌘ ⌦` (macOS System Shortcuts), `Alt+Delete` (XWin), `Alt+Delete` (GNOME), `Alt+Delete` (KDE), `Alt+Delete` (Emacs), `Alt+Delete` (Sublime Text), `⌘ ⌦` (Sublime Text (macOS)), `Ctrl+R, D` (Visual Studio), `⌘ R, D` (Visual Studio (macOS)), `Alt+Delete` (NetBeans), `Alt+Delete` (Eclipse), `Alt+Delete` (Eclipse (macOS))  |  点击此按钮以删除所选的  File Watcher 。  File Watcher  不再应用于当前项目中的文件。 请注意，此操作不会影响相应的预定义模板，它仍然在 IntelliJ IDEA 级别可用。  |
|  ![上一个匹配按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.up.svg)  ![“下一个匹配项”按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.down.svg)  |     上 `Ctrl+Alt+Up` (Windows), `⌘ ⌥ ↑` (macOS), `⌘ ⌥ ↑` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ ↑` (macOS System Shortcuts), `Ctrl+Alt+Up` (XWin), `Alt+Shift+Up` (GNOME), `Ctrl+Alt+Up` (KDE), `Ctrl+Alt+Up` (Emacs), `Ctrl+Alt+Up` (Sublime Text), `Ctrl+Alt+Up` (Sublime Text (macOS)), `Ctrl+Alt+Up` (Visual Studio), `⌘ ⌥ ↑` (Visual Studio (macOS)), `Ctrl+Alt+Up` (NetBeans), `Ctrl+Alt+Up` (Eclipse), `Ctrl+Alt+Up` (Eclipse (macOS))       下 `Ctrl+Alt+Down` (Windows), `⌘ ⌥ ↓` (macOS), `⌘ ⌥ ↓` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ ↓` (macOS System Shortcuts), `Ctrl+Alt+Down` (XWin), `Alt+Shift+Down` (GNOME), `Ctrl+Alt+Down` (KDE), `Ctrl+Alt+Down` (Emacs), `Ctrl+Alt+Down` (Sublime Text), `Ctrl+Alt+Down` (Sublime Text (macOS)), `Ctrl+Alt+Down` (Visual Studio), `⌘ ⌥ ↓` (Visual Studio (macOS)), `Ctrl+Alt+Down` (NetBeans), `Ctrl+Alt+Down` (Eclipse), `Ctrl+Alt+Down` (Eclipse (macOS))     |  使用这些按钮更改列表中  File Watcher 的顺序。 如果启用了多个，这将决定启动  File Watchers  的顺序。  |
|  ![复制](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.copy.svg)  |  复制  |  使用此按钮创建所选 File Watcher 的副本。  |
|  ![import](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.import.svg)  |  导入  |  点击此按钮以导入现有的 File Watcher 并将其添加到可用 File Watcher 列表中。  |
|  ![导出](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.export.svg)  |  导出  |  点击此按钮将选定的 watchers 导出到用户主目录下的  `watchers.xml`  文件。  |

## See also

### 过程

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

### 参考

[新建监视器对话框](new-watcher-dialog.html)