新建监视器对话框

文件类型

请使用此列表指定预期的输入文件类型。 文件关注者将仅把此类型的文件视为分析和处理对象。 文件类型是根据 文件类型和文件扩展名之间的关联来识别的。

范围

使用此列表定义文件关注者可应用到的文件范围。

这些文件中的更改会根据 自动保存已编辑的文件以触发监视器 复选框的状态，立即或在保存或框架停用时调用文件关注者。

从列表中选择一个预定义作用域。 对于项目级文件关注者，还可以点击 在打开的 作用域 对话框中配置自定义作用域。

• 所有位置： 以下列出的所有作用域。

• 项目文件： 项目内容根目录中的所有文件（请参阅 内容根）。

• 项目生产文件： 项目内容根中的所有文件，不包括测试源。

• 项目测试文件： 项目测试源根目录中的所有文件。

• 临时文件和控制台： 位于 项目 工具窗口中的 临时文件和控制台 目录中的所有文件。

• 打开的文件： 当前在编辑器中打开的所有文件。

• 当前文件： 在活动编辑器选项卡中打开的文件。

VCS 范围： 这些范围仅在您的 项目处于版本控制下时才可用。

• 所有更改的文件： 所有已更改的文件，即与所有现有更改列表关联的所有文件。

• 默认更改列表： 与更改列表  默认 关联的所有文件。

或者，点击 ，并在打开的 作用域 对话框中配置 自定义作用域。

仅跟踪根文件

根文件是不会（例如通过 import ）被 指定作用域内的任何其他文件包含的文件。

• 当选中此复选框时，File Watcher 仅针对 root files运行。

• 清除此复选框后，文件关注者会针对调用它的文件，以及在指定作用域内递归包含该文件的所有文件运行。

请注意， 范围 设置会重写 仅跟踪根文件 复选框设置：如果依赖项位于指定作用域之外，则不会对其应用文件关注者。

例如 假设您有两个文件 root.scss 和 another.scss ，其中 root.scss 导入了 another.scss 。 在选中 仅跟踪根文件 复选框的情况下，编辑 another.scss 只会调用 root.scss 上的File Watcher。 否则，如果选中框未选中，File Watcher 将处理这两个文件。

程序

在此字段中，指定工具的可执行文件的路径( .com 、 .exe 、 .cmd 、 .bat 或其他，具体取决于具体的工具)。

参数

在此字段中，定义传递给工具的参数，从而影响其行为。

参数通常使用 宏指定，例如， $FileName$ 或 $FileNameWithoutExtension$ ，这些将被替换为实际的文件名。

手动输入宏，或点击 ，并在打开的 宏 对话框的列表中选择相关模式。

要刷新的输出路径

在此字段中，告诉 IntelliJ IDEA 应该在哪里搜索工具的输出：生成的源代码、源映射、依赖项或文件本身。 输出位置是特定于工具的。

通常使用 宏 指定输出路径。 可以手动输入它们，或点击 ，并在打开的对话框的列表中选择相关项。

要指定多个宏，请使用冒号 : 作为分隔符，例如， $FileNameWithoutExtension$.css:$FileNameWithoutExtension$.css.map。

工作目录

在此字段中，指定将工具应用的目录。 由于工具始终在文件上下文中调用，因此默认工作目录是当前文件的目录。 默认工作目录在所有预定义模板中通过 $FileDir$ 宏指定。 要指定自定义工作目录，请在字段中输入其路径，或点击 并在 选择路径 对话框中选择目录，或点击 并选择所需的 宏 （位于 宏 对话框的列表中）。

环境变量

在此字段中，指定工具所需但在操作系统级别未指定的环境变量。

自动保存已编辑的文件以触发监视器

• 选中此复选框后，IntelliJ IDEA 会在您编辑文件时立即保存该文件，从而使 File Watcher 立即启动。

• 清除此复选框后，文件关注者会在保存（文件 | 全部保存 ）时或当焦点从 IntelliJ IDEA 移开时（框架停用）启动。

在外部更改时触发监视器

• 选中此复选框后，文件关注者会在其作用域内的文件发生任何更改时唤醒，包括在 IntelliJ IDEA 外部进行的更改，或在版本控制系统中检出分支后的更改。

• 清除此复选框后，文件关注者仅在其作用域内的文件从 IntelliJ IDEA 更新时启动，并忽略其他更改，例如从版本控制系统接收的更改。

无论是否存在语法错误都触发关注者

• 选中复选框时，File Watcher 会在文件语法正确与否的情况下启动。 根据 自动保存已编辑的文件以触发监视器 复选框的状态，文件观察器将在更新、保存或撤销框架时启动。

• 清除此复选框时，File Watcher 会忽略语法无效文件中的所有触发器，仅在无错误的文件中启动。

从 stdout 创建输出文件

• 在大多数情况下，应该取消选中此复选框，因为大多数工具直接将输出写入相关文件。

• 选中此复选框时，IntelliJ IDEA 会读取本机工具的输出 标准输出流 (stdout) 并由其生成结果文件。 生成文件的名称取自 要刷新的输出路径 字段。 如果该字段包含多个名称，将使用列表中的第一个。

显示控制台

从此列表中选择您希望 File Watcher 何时打开控制台。

• 始终： 使用此选项时，工具执行完成后始终打开控制台。

• 出错时： 使用此选项时，仅当 退出代码 不同于 0 时，工具执行后才会打开控制台。

• Never: 选择此选项可完全禁止打开控制台。

输出过滤器

在此字段中，指定与该工具关联的输出过滤器。 根据这些过滤器，工具输出中的绝对文件路径和行号会转换成超链接。 点击这些链接将在编辑器中打开相应的文件。

例如，要显示有用的错误信息，请输入 $FILE_PATH$:$LINE$ $MESSAGE$