新建 Watcher 对话框

文件类型

使用此列表可指定输入文件的预期类型。 File Watcher 仅会分析和处理此类型的文件。 文件类型是基于 文件类型与文件扩展名之间的关联进行识别的。

作用域

使用此列表定义可应用 File Watcher 的文件范围。

这些文件的更改将立即，或在保存或窗口失去焦点时根据 自动保存已编辑文件以触发监视器 复选框的状态触发 File Watcher。

从列表中选择一个预定义作用域。 对于项目级 File Watcher，您也可以单击 ，在打开的 范围 对话框中配置自定义作用域。

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

• 项目文件： 项目中的所有文件

• 草稿与控制台：文件 工具窗口（视图 | 工具窗口 | 文件 ）中的所有 scratch 和控制台。

• 最近查看的文件： 编辑器中最近查看的所有文件

• 最近更改的文件： 编辑器中最近更改的所有文件。

• 模块： 当前模块中的所有文件。

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

• 所有已更改的文件： 所有修改过的文件，即所有关联到现有变更列表的文件。

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

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

仅跟踪根文件

根文件 是指未被 指定范围 内的任何其他文件包含的文件（例如通过 import）。

• 选中此复选框后，File Watcher 仅对 根文件运行。

• 未选中该复选框时，File Watcher 将对其被调用的文件及该文件被其他文件递归包含的所有文件运行，前提是文件位于指定作用域中。

请注意， 范围 设置优先于 仅跟踪根文件 复选框设置：如果依赖项位于指定作用域之外，则 File Watcher 不适用于该依赖项。

示例  假设您有两个文件 root.scss 和 another.scss ，其中 root.scss 导入了 another.scss 。 选中 仅跟踪根文件 复选框后，编辑 another.scss 仅会触发针对 root.scss 的 File Watcher。 否则，如果未选中复选框，File Watcher 将处理这两个文件。

程序

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

参数

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

参数通常使用 宏 指定，例如， $FileName$ 或 $FileNameWithoutExtension$ ，它们将在运行时替换为实际文件名。

您可以手动输入宏，或单击 并在打开的 宏 对话框中从列表中选择相应的模式。

要刷新输出路径

在此字段中，告知 GoLand 应在哪些位置查找工具的输出内容：包括生成的源代码、source map、依赖项或文件本身。 输出位置因工具而异。

输出路径通常使用 宏 进行指定。 您可以手动输入宏，或单击 ，然后在打开的对话框中从列表中选择相应宏。

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

工作目录

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

环境变量

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

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

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

• 取消选中该复选框后，File Watcher 会在保存（文件 | 全部保存 ）或您从 GoLand 移动焦点（窗口失去焦点）时才启动。

在外部更改时触发监听器

• 选中该复选框后，File Watcher 会在工具适用范围内的文件发生任何更改时激活，包括在 GoLand 外部所做的更改，或在版本控制系统中检出分支后发生的更改。

• 取消选中该复选框后，File Watcher 仅在相关范围内的文件由 GoLand 更新时才会启动，忽略例如来自版本控制系统的更改等其他更改。

无论语法错误是否存在均触发监听器

• 选中此复选框时，无论文件语法是否正确，文件监视器都会启动。 File Watcher 会在文件更新、保存或窗口失去焦点时启动，该行为取决于 自动保存已编辑文件以触发监视器 复选框的状态。

• 取消选中该复选框后，File Watcher 会忽略所有语法无效文件中的触发操作，仅在无语法错误的文件中启动。

从 stdout 创建输出文件

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

• 选中该复选框后，GoLand 会读取原生工具的输出 标准输出流（stdout） 并根据其生成结果文件。 生成文件的名称来源于 需刷新输出路径 字段。 如果该字段包含多个名称，则使用列表中的第一个名称。

显示控制台

从此列表中选择 File Watcher 打开控制台的时间。

• 始终： 选择该选项后，每次工具执行完成后都会打开控制台。

• 发生错误时： 选择该选项后，只有在 退出代码 与 0 不相同时才会打开控制台。

• 从不： 选择此选项可完全禁止打开控制台。

输出过滤器

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

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