File Watchers
File Watcher 是 一个 IntelliJ IDEA 工具，当您在 IDE 中更改或保存文件时，允许您自动运行类似编译器、格式化工具或 linters 的命令行工具。
文件监视器有两个专用的 代码检查：
每个文件中都会运行 File Watcher available检查，只要有预定义的 File Watcher。 如果项目未配置相关的 File Watcher，IntelliJ IDEA 建议添加一个。
由正在运行的 File Watcher 调用的 File Watcher problems检查会突出显示特定于它的错误。
您可以使用现有的模板之一或从头开始配置 File Watcher。 配置好的 File Watcher 可以保存在您的项目设置或 IDE 设置中，并在不同的项目中使用。
有关特定工具的文件监视器的更多信息，请参阅相应页面：
请注意，在 IntelliJ IDEA 中使用其中的一些工具需要您在 设置 | 插件 页面上安装插件，如 从 JetBrains Marketplace 安装插件中所述。
开始之前
安装并启用 File Watchers插件，在 设置 | 插件 页面， Marketplace 选项卡中，如 从 JetBrains Marketplace 安装插件中所述。
创建文件观察器
在 设置 对话框（Ctrl+Alt+S ）中，点击 File Watchers 下的 工具。 “ 文件监视器页面 ”打开，显示了该项目和 IDE 中已配置的文件监视器列表。
点击
并选择您要从中创建File Watcher的预定义模板。 选择取决于您将要使用的工具。 若要使用不在列表中的工具，请选择 自定义。
新建 Watcher 对话框打开。
在 名称 字段中，输入文件监视器的名称。 默认情况下，IntelliJ IDEA 会建议使用所选的预定义模板名称。
配置输入文件的预期类型和位置
请使用 要观察的文件 区域的控件定义您想要应用文件监视器的文件范围。
从 文件类型 列表中选择预期类型的输入文件。 文件监视器将仅考虑此类型的文件进行分析和处理。 文件类型基于 文件类型与文件扩展名之间的关联进行识别。
默认情况下，该字段按照选择的预定义模板显示文件类型。
请选择适用文件监视器的 范围。
这些文件的更改将根据 自动保存编辑的文件以触发观察程序 复选框的状态，立即或在保存或框架停用时调用 File Watcher。
从列表中选择一个预定义的范围。 对于项目级文件监视器，您也可以点击
，在打开的 作用域 对话框中配置自定义范围。所有位置: 下面列出的所有作用域。
项目文件： 项目内容根目录中的所有文件（请参阅 内容根）。
生产项目文件： 项目的内容根目录中的所有文件，测试源除外。
项目测试文件： 项目测试源根目录中的所有文件。
临时文件和控制台： 所有文件从 临时文件与控制台 目录中位于 项目 工具窗口。
打开文件： 当前在编辑器中打开的所有文件。
当前文件: 在活动编辑器选项卡中打开的文件。
VCS 范围： 这些范围仅在您的 项目处于版本控制下时才可用。
所有更改的文件： 所有更改文件，即与所有现有更改列表相关的所有文件。
默认更改列表: 与 changelist 相关的所有文件
默认。
或者，点击
并在打开的 自定义范围 对话框中配置 范围。可选地 ：指定您希望 File Watcher 如何处理依赖项。 一个 root file 是一个未包括在（例如，通过
import） 指定范围内的任何其他文件中的文件。要仅针对根文件运行 File Watcher，请选择 仅跟踪根文件 复选框。
清除该复选框以对调用它的文件以及在指定范围内递归包含此文件的所有文件运行 File Watcher。
注意， 范围 设置会覆盖 仅跟踪根文件 复选框设置：如果某个依赖项超出指定范围，则 File Watcher 不适用于它。
配置与外部工具的交互
在 更改时运行的工具 区域，指定要使用的工具、传递给它的参数、预期的输出文件类型等。
在 程序(P) 字段中，指定工具的可执行文件的路径（ .exe 、 .cmd 、 .bat 或其他，具体取决于具体的工具）。
在 实参(A) 字段中，定义传递给工具的参数。
参数通常使用 宏指定，例如，
$FileName$或$FileNameWithoutExtension$，这些将被替换为实际的文件名。手动键入宏或点击
，然后在打开的 宏 对话框中从列表中选择相关模式。在 要刷新的输出路径(O) 字段中，指定工具存储其输出结果的文件：生成的源代码、源地图和依赖项。 基于这些设置，IntelliJ IDEA 识别通过编译生成的文件。
通常使用 宏 指定输出路径。 您可以手动输入它们，或点击
并在打开的对话框中从列表中选择相关的项。要指定多个宏，请使用冒号
:作为分隔符，例如，$FileNameWithoutExtension$.css:$FileNameWithoutExtension$.css.map。展开 工作目录和环境变量 隐藏区域。
定义环境变量。 例如，为 您 正在配置但路径中未引用的工具指定
PATH变量，其中包含启动该工具所需的工具。 在大多数情况下，它是 Node.js 或 ruby.exe。 这种情况可能是由于使用自定义手动安装而非通过 Node Package Manager (npm) 或 gem manager 进行安装导致的。在 工作目录(W) 字段中，指定工具将应用到的目录。
由于该工具始终在文件上下文中调用，因此默认工作目录是当前文件所在的目录。 默认工作目录在所有预定义模板中使用
$FileDir$宏进行指定。 要指定自定义工作目录，请在该字段中键入路径，或点击
并在 选择路径 对话框中选择目录，或点击 并从 宏 对话框中的列表中选择所需的 宏。
配置高级选项
在 高级选项 区域，定制 File Watcher 的默认行为。
指定将触发 File Watcher 的事件：
若要在对源代码进行任何更改后立即调用 File Watcher，请选中 自动保存编辑的文件以触发观察程序 复选框。
当复选框被清除时，File Watcher 会在保存后启动 () 或当您将焦点从 IntelliJ IDEA 移开时（在窗口失活时）。
文件监视器默认在任何已保存的更改时唤醒，包括当您从版本控制系统收到更新时，例如检出分支。 要忽略此类更改并仅在您更新 IntelliJ IDEA 中的代码时调用 Watcher，请取消选中 外部更改触发观察程序 复选框。
指定是否希望 File Watcher 与 IntelliJ IDEA 语法解析器进行交互：
当选中 触发监视程序，无论语法错误如何 复选框时，File Watcher 会在文件语法正确与否的情况下启动。 文件监视器将根据 自动保存编辑的文件以触发观察程序 复选框的状态在更新、保存或框架停用时启动。
当清除 触发监视程序，无论语法错误如何 复选框时，File Watcher 会忽略语法无效文件中的所有触发器，仅在无错误的文件中启动。
使用 从 stdout 创建输出文件 复选框来指定您希望如何生成输出文件。
当选中复选框时，IntelliJ IDEA 会读取本机工具的输出
standard output stream (stdout)并生成结果文件。选中复选框时，该工具会将其输出直接写入 要刷新的输出路径 字段中指定的文件。
在 显示控制台 列表中，选择您希望 File Watcher 何时打开控制台。
始终: 使用此选项，工具执行完成后控制台始终会打开。
出错时： 使用此选项，只有当
Exit code不同于0时，控制台才会在工具执行后打开。Never: 选择此选项可完全禁止打开控制台。
在编辑器中显示由 File Watcher 报告的信息
如果 File Watcher 中配置的工具报告了包含文件和特定行链接的代码错误或警告，您可以在编辑器中直接查看此信息：
在 中，启用检查 文件监视器问题。
在 输出过滤器 字段中， 编辑观察器 对话框描述您想匹配的输出格式。 请使用宏
$FILE_PATH$、$LINE$和$MESSAGE$。 您需要避免使用像大括号和点这样的特殊符号\。 与$MESSAGE$宏匹配的文本将显示在编辑器中。
示例
该工具以以下格式报告错误：
请使用以下正则表达式作为输出过滤器，以在编辑器中看到错误高亮：
保存、启用与禁用 File Watchers
保存新的 File Watcher 后，您可以决定它是仅在当前项目中可用（从 项目 列表中选择 级别 ）还是在所有项目中可用（选择 全局）。
要启用或禁用 File Watcher，请打开 设置 对话框（Ctrl+Alt+S ），转到 ，然后选中或清除其旁边的复选框。
当您打开一个适用于预定义 File Watcher 的文件时，IntelliJ IDEA 会建议启用该 File Watcher：
border-effect="line" />
启用 File Watcher 后，只要选定范围内的选定类型文件被更改或保存，它就会自动启动，详见 配置高级选项。
如果 File Watcher 运行时发生错误，File Watcher 会自动禁用。 若要恢复状态，请手动启用 File Watcher。
为新项目启用全局 File Watchers
Global 文件监视器可以在您将来创建的所有新项目中自动启用。
打开 新项目设置 对话框 () ，转到 ，并选中所需 File Watchers 旁边的复选框。
或者，在 欢迎界面 上，从 配置 列表中选择 设置。 在打开的对话框中，选中相关 File Watchers 旁边的复选框。
自定义 File Watcher 中外部工具行为的示例
影响第三方工具的唯一方法是传递参数，就像您在命令行模式下工作一样。 这些参数是每个工具特有的。 下面是有关自定义默认输出位置的两个示例： SCSS 编译器。
自定义 SCSS 编译器
假设您的项目结构如下：
正如您所见， _grid.scss 已导入至 Page.scss 。 下面的示例展示了当您手动或自动保存项目时， Page.scss 如何被编译成 CSS，以及对 _grid.scss 的更改如何反映在生成的 CSS 文件中。
创建一种类型为 SCSS 的 File Watcher：打开 设置 对话框（Ctrl+Alt+S ），转到 ，点击工具栏上的
，并从列表中选择 SCSS。在打开的 新文件监视器 对话框中，所有必填字段都已填写。
实际上，这些设置足以成功运行编译器。
让我们更改 grid.scss ，例如，将第 31 行的
margin-left: 0;替换为margin-left: 12px;。 这将触发我们的 File Watcher，编译器将处理 Page.scss 。 因此，将生成两个文件并在 Page.scss 下嵌套显示：Page.css 与已编译的 CSS 代码
Page.css.map 以及源映射，允许您在调试会话期间逐步调试应用程序。
虽然默认设置足以成功运行编译器，但我们仍然仔细看看它们，了解如何自定义 File Watcher 的行为。
更改触发文件监视器的操作
文件监视器在您的项目被手动（ 或 Ctrl+S ）或自动保存后立即唤醒并启动转译器。
一般来说，当您将焦点从 IntelliJ IDEA 移开（窗口失活）时，您的代码会自动保存。 使用 File Watchers 时，当您从 File Watcher's 范围内编辑文件时，也会执行自动保存。 因此，转译器可能在您键入时一直运行，这可能会导致性能问题。 要解决此问题，请抑制自动保存已编辑的文件。
按 Ctrl+Alt+S 打开设置，然后选择 。 选择所需的 File Watcher（SCSS 在我们的示例中），然后点击工具栏上的 
。 在 编辑文件监视器 对话框中，展开 高级选项 区域，清除 自动保存编辑的文件以触发观察程序 复选框。
默认情况下，即使在 IntelliJ IDEA 之外编辑其范围内的文件，文件监视器也会被唤醒。 要重写此行为并仅在内部编辑时编译文件，请清除 外部更改触发观察程序 复选框。
更改范围
默认情况下，IntelliJ IDEA 监控整个项目中所有带有 .scss 扩展名的文件的更改。 这适用于我们的示例。 然而，您可以更改范围以处理例如仅未提交的更改。 在大型项目中，这将节省时间。
按 Ctrl+Alt+S 打开设置，然后选择 。 选择所需的 File Watcher（SCSS 在我们的示例中），然后点击工具栏上的 。 在 编辑文件监视器 对话框中，从列表中选择适用的范围。 请从 文件范围与文件颜色 了解更多。
自定义输出位置
默认情况下，生成的 .css 和 .css.map 文件存储在原始文件所在的文件夹中，并作为其子项显示在 项目 工具窗口 Alt+1 中。 您可以更改此默认行为，将所有生成的 .css 和 .css.map 文件存储在单独的文件夹中。
让我们从一个简单的案例开始。 假设您在项目根目录有一个 custom_output.scss 文件。
我们来编辑 custom_output.scss ，例如，将第6行的 fill-opacity: abs(50); 替换为 fill-opacity: abs(60);。 默认的 File Watcher 配置中，生成的文件 custom_output.css 和 custom_output.css.map 将存储在项目根目录，并显示为 custom_output.scss 的子项。
将所有输出存储在一个单独的文件夹中会很方便，例如， css 。 让我们使用 css 文件夹作为输出位置创建一个自定义 SCSS_custom_output File Watcher。
按 Ctrl+Alt+S 打开设置，然后选择 。 然后创建一个 SCSS File Watcher 如上所述。
将默认设置更新如下：
在 实参 字段中，输入：
$FileName$:$ProjectFileDir$/css/$FileNameWithoutExtension$.css在 要刷新的输出路径 字段中，输入：
$ProjectFileDir$/css/$FileNameWithoutExtension$.css:$ProjectFileDir$/css/$FileNameWithoutExtension$.css.map
保存新建的文件监视器，并确保其已启用。
现在，如果您编辑 custom_output.scss ，例如，将第六行的 fill-opacity: abs(50); 替换为 fill-opacity: abs(60); ，IntelliJ IDEA 将创建一个 css 文件夹并将生成的 custom_output.css 和 custom_output.css.map 文件存储在其中。
自定义输出位置：保持原有的文件夹结构
现在让我们考虑一个示例，其中 .scss 文件存储在一个文件夹结构中，例如：
默认的 File Watcher 会将生成的文件存储在原始 .scss 文件旁边。
如果我们使用自定义 File Watcher 如上所述 ，所有生成的文件将存储在同一个 css 文件夹中：
为了让 IntelliJ IDEA 保留文件夹结构，让我们创建另一个自定义 File Watcher。
按 Ctrl+Alt+S 打开设置，然后选择 。 然后创建一个 SCSS File Watcher 如上所述。
将默认设置更新如下：
在 实参 字段中，输入：
$FileName$:$ProjectFileDir$/css/$FileDirRelativeToProjectRoot$/$FileNameWithoutExtension$.css在 要刷新的输出路径 字段中，输入：
$ProjectFileDir$/css/$FileDirRelativeToProjectRoot$/$FileNameWithoutExtension$.css:$ProjectFileDir$/css/$FileDirRelativeToProjectRoot$/$FileNameWithoutExtension$.css.map
保存新建的文件监视器，并确保其已启用。
现在，如果您编辑 custom_output_body.scss 、 custom_output_header.scss 或 custom_output_footer.scss ，IntelliJ IDEA 会创建一个带有子文件夹结构的 css 文件夹，保留 styles_structured 的结构。
自定义 CoffeeScript 编译器
假设您有一个具有以下文件夹结构的项目：
默认的 File Watcher 生成的文件将显示为其原始文件的子文件。
您可以更改此默认位置，并将生成的文件存储在单独的 JavaScript 文件夹中。
将所有生成的文件存储在 output JavaScript 文件夹中。
在 实参 字段中，输入：
--map --compile -o $ProjectFileDir$/JavaScript $FileName$在 要刷新的输出路径 字段中，输入：
$ProjectFileDir$/JavaScript/$FileNameWithoutExtension$.js:$ProjectFileDir$/JavaScript/$FileNameWithoutExtension$.map:$FileNameWithoutExtension$.js.map
因此，项目树如下所示：
生成文件也可以存储在 app 节点下重复原始结构的文件夹结构中。
在输出文件夹中保留原始文件夹结构
创建一个 CoffeeScript 文件监视器。
在 实参 字段中，输入：
--map --compile -o $ProjectFileDir$/JavaScript/$FileDirRelativeToProjectRoot$ $FileName$在 要刷新的输出路径 字段中，输入：
$ProjectFileDir$/JavaScript/$FileDirRelativeToProjectRoot$/$FileNameWithoutExtension$.js:$ProjectFileDir$/JavaScript/$FileDirRelativeToProjectRoot$/$FileNameWithoutExtension$.map:$FileNameWithoutExtension$.js.map
因此，项目树如下所示：
文件监视器故障排除
可能会显示一个弹出窗口，其中包含错误消息，同时通知您 File Watcher 已被禁用
这里是可能出现的错误列表：
已报告的问题 | 问题描述 | 解决方法 |
|---|---|---|
| 文件监视器使用在此项目中未定义的范围。 | 双击观察器并选择可用的作用域或创建一个新的。 |
| 该项目使用了一个已被删除的全局 File Watcher。 | 使用 移除 按钮 |
IntelliJ IDEA 运行多个相同的 File Watcher 任务 | 在进行批量更新之后，例如来自您的 VCS，IntelliJ IDEA 会为每个保存的文件运行一个单独的 File Watcher 任务。 | 在 实参 字段中添加文件特定的宏（如 |
从列表中删除观察者，或编辑它以创建一个具有相同名称的新全局观察者。