文件监视器
文件监视器 是 一个 GoLand 的工具，允许您在 IDE 中更改或保存文件时自动运行命令行工具，例如编译器、格式化工具或代码检查工具。
文件监视器有两个专用的 代码检查：
文件监视器可用检查会在每个可应用预定义文件监视器的文件中运行。 如果项目未配置相关的文件监视器，GoLand 会建议添加一个文件监视器。
文件监视器问题检查由正在运行的文件监视器触发，并高亮显示其特定错误。
您可以使用现有的模板之一或从头开始配置 File Watcher。 配置好的 File Watcher 可以保存在您的项目设置或 IDE 设置中，并在不同的项目中使用。 下图列出了文件监视器的预定义模板。 您无法修改预定义模板的列表。
有关特定工具的文件监视器的更多信息，请参阅相应页面：
请注意，在 GoLand 中使用其中的一些工具需要您在 设置 | 插件 页面上安装插件，如 从 JetBrains Marketplace 安装插件中所述。
创建文件观察器
在 设置 对话框（Ctrl+Alt+S ）中，点击 文件监视器 下的 工具。 “ 文件监视器页面 ”打开，显示了该项目和 IDE 中已配置的文件监视器列表。
点击
并选择您要从中创建File Watcher的预定义模板。 选择取决于您将要使用的工具。 若要使用不在列表中的工具，请选择 自定义。新建 Watcher 对话框打开。
在 名称 字段中，键入文件监视器的名称。 默认情况下，GoLand 会建议所选预定义模板的名称。
配置输入文件的预期类型和位置
使用 要监视的文件 区域中的控件来定义您希望应用文件监视器的文件范围。
从 文件类型 列表中选择预期类型的输入文件。 文件监视器将仅把此类型的文件视为分析和处理的对象。 文件类型基于 文件类型与文件扩展名之间的关联进行识别。
默认情况下，该字段会根据所选预定义模板显示文件类型。
请选择适用文件监视器的 范围。
这些文件中的更改将立即或在保存或框架停用时调用文件监视器，具体取决于 自动保存已编辑的文件以触发监视器 复选框的状态。
从列表中选择一个预定义作用域。 对于项目级文件监视器，您还可以点击
，并在打开的 范围 对话框中配置自定义范围。所有位置： ：以下列出的所有范围。
项目文件： 项目中的所有文件
临时文件和控制台：个文件 工具窗口（ ）中的所有草稿和控制台。
最近查看的文件: 编辑器中最近查看的所有文件。
最近更改的文件: 编辑器中最近更改的所有文件。
模块: 当前模块中的所有文件。
当前文件： 在活动编辑器选项卡中打开的文件。
所有更改的文件： ：所有已更改的文件，即与所有现有变更列表关联的所有文件。
默认更改列表： ：与变更列表 
Default关联的所有文件。
或者，点击
，并在打开的 范围 对话框中配置 自定义范围。有关更多信息，请参阅 范围。
配置与外部工具的交互
在 更改时运行的工具 区域，指定要使用的工具、传递给它的参数、预期的输出文件类型等。
在 程序(P) 字段中，指定工具的可执行文件的路径（ .exe 、 .cmd 、 .bat 或其他，具体取决于具体的工具）。
在 实参(A) 字段中，定义传递给工具的参数。
参数通常使用 宏指定，例如，
$FileName$或$FileNameWithoutExtension$，这些将被替换为实际的文件名。手动键入宏，或点击
，并在打开的 宏 对话框的列表中选择相关模式。在 要刷新的输出路径(O) 字段中，指定工具存储其输出结果的文件：生成的源代码、源地图和依赖项。 基于这些设置，GoLand 识别通过编译生成的文件。
通常使用 宏 指定输出路径。 您可以手动键入它们，或点击
，并在打开的对话框中的列表中选择相应项。要指定多个宏，请使用冒号
:作为分隔符，例如，$FileNameWithoutExtension$.css:$FileNameWithoutExtension$.css.map。展开 工作目录和环境变量 隐藏区域。
定义环境变量。 例如，为 您 正在配置但路径中未引用的工具指定
PATH变量，其中包含启动该工具所需的工具。在 工作目录(W) 字段中，指定工具将应用到的目录。
由于该工具始终在文件的上下文中调用，默认工作目录为当前文件的目录。 默认工作目录在所有预定义模板中通过
$FileDir$宏指定。 要指定自定义工作目录，请在该字段中键入其路径，或点击
并在 选择路径 对话框中选择目录，或点击 并在 宏 对话框的列表中选择所需的 宏。
配置高级选项
在 高级选项 区域，定制 File Watcher 的默认行为。
指定将触发 File Watcher 的事件：
若要在对源代码进行任何更改后立即调用 File Watcher，请选中 自动保存已编辑的文件以触发监视器 复选框。
清除此复选框后，文件监视器会在保存（ ）时或当您将焦点从 GoLand 移开时（框架停用）启动。
文件监视器默认在任何已保存的更改时唤醒，包括当您从版本控制系统收到更新时，例如检出分支。 要忽略此类更改并仅在您更新 GoLand 中的代码时调用 Watcher，请取消选中 在外部更改时触发监视器 复选框。
指定是否希望 File Watcher 与 GoLand 语法解析器进行交互：
当选中 无视语法错误触发监视器 复选框时，文件监视器会在文件语法正确与否的情况下启动。 文件监视器将根据 自动保存已编辑的文件以触发监视器 复选框的状态在更新、保存或框架停用时启动。
当清除 无视语法错误触发监视器 复选框时，文件监视器会忽略语法无效文件中的所有触发器，仅在无错误的文件中启动。
使用 从 stdout 创建输出文件 复选框来指定您希望如何生成输出文件。
当选中复选框时，GoLand 会读取本机工具的输出
standard output stream (stdout)并生成结果文件。选中复选框时，该工具会将其输出直接写入 要刷新的输出路径 字段中指定的文件。
在 显示控制台 列表中，选择您希望 File Watcher 何时打开控制台。
始终： 使用此选项时，工具执行完成后始终打开控制台。
出错时： 使用此选项时，仅当
Exit code不同于0时，工具执行后才会打开控制台。Never: 选择此选项可完全禁止打开控制台。
在编辑器中显示由 File Watcher 报告的信息
如果 File Watcher 中配置的工具报告了包含文件和特定行链接的代码错误或警告，您可以在编辑器中直接查看此信息：
在 中，启用检查 文件监视器问题。
在 编辑监视器 对话框的 输出过滤器 字段中，描述您想要匹配的输出格式。 请使用宏
$FILE_PATH$、$LINE$和$MESSAGE$。 您需要避免使用像大括号和点这样的特殊符号\。 与$MESSAGE$宏匹配的文本将显示在编辑器中。
保存、启用与禁用 File Watchers
保存新的文件监视器后，您可以决定它是仅在当前项目中可用（从 级别 列表中选择 项目 ）还是对所有项目可用（选择 全局）。
要启用或禁用文件监视器，请打开 设置 对话框（Ctrl+Alt+S ），转到 ，并选中或清除其旁边的复选框。
当您打开一个适用于预定义文件监视器的文件时，GoLand 会建议启用文件监视器：
border-effect="line" />
启用文件监视器后，只要所选类型且位于所选范围内的文件被更改或保存，它就会自动启动，参阅 配置高级选项。
如果在 File Watcher 运行时发生错误，将会自动禁用该 File Watcher。 若要恢复状态，请手动启用 File Watcher。
在保存时自动运行文件监视器
您可以将 IDE 配置为在您的更改被 保存 时，自动在已修改的文件中运行 File Watcher。
按下 Ctrl+Alt+S 打开设置，然后选择 。
启用 File Watcher 选项并应用更改。
为新项目启用全局文件监视器
Global 文件监视器可以在您将来创建的所有新项目中自动启用。
打开 新项目设置 对话框 () ，转到 ，并选中所需 File Watchers 旁边的复选框。
或者，在 欢迎界面 上，从 配置 列表中选择 设置。 在打开的对话框中，选中相关 File Watchers 旁边的复选框。
文件监视器故障排除
可能会显示一个弹出窗口，带有错误消息，同时通知您文件监视器已被禁用。
这里是可能出现的错误列表：
已报告的问题 | 问题描述 | 解决方法 |
|---|---|---|
| 该文件监视器使用了在此项目中未定义的范围。 | 双击观察器并选择可用的作用域或创建一个新的。 |
| 该项目使用了一个已被删除的全局 File Watcher。 | 使用 移除 按钮 |
GoLand 运行多个相同的 File Watcher 任务 | 在进行批量更新之后，例如来自您的 VCS，GoLand 会为每个保存的文件运行一个单独的 File Watcher 任务。 | 在 参数 字段中添加文件特定的宏（如 |
从列表中删除观察者，或编辑它以创建一个具有相同名称的新全局观察者。提示与技巧
将 gofumpt 配置为 File Watcher
按下 Ctrl+Alt+S 打开设置，然后选择 。
点击 添加 按钮（
）以添加新的 File Watcher，并选择 gofumpt。点击 确定 以保存新的关注者。
