文件监视器

1. 在 设置 对话框（Ctrl+Alt+S ）中，点击 文件监视器 下的 工具。 “ 文件监视器页面 ”打开，显示了该项目和 IDE 中已配置的文件监视器列表。

2. 点击 并选择您要从中创建File Watcher的预定义模板。 选择取决于您将要使用的工具。 若要使用不在列表中的工具，请选择 自定义。

   

   新建 Watcher 对话框打开。

3. 在 名称 字段中，键入文件监视器的名称。 默认情况下，CLion 会建议所选预定义模板的名称。

1. 从 文件类型 列表中选择预期类型的输入文件。 文件监视器将仅把此类型的文件视为分析和处理的对象。 文件类型基于 文件类型与文件扩展名之间的关联进行识别。

   默认情况下，该字段会根据所选预定义模板显示文件类型。

2. 请选择适用文件监视器的 范围。

   

   这些文件中的更改将立即或在保存或框架停用时调用文件监视器，具体取决于 自动保存已编辑的文件以触发监视器 复选框的状态。

   从列表中选择一个预定义作用域。 对于项目级文件监视器，您还可以点击 ，并在打开的 范围 对话框中配置自定义范围。

   • 所有位置： ：以下列出的所有范围。

   • 项目文件： 项目根目录内的所有文件。

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

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

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

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

   欲了解更多信息，请参阅 文件作用域与文件颜色。

3. 可选地 ：指定您希望 File Watcher 如何处理依赖项。 根文件是在 指定范围内未被包含到任何其他文件中的文件（例如通过 import）。

   • 要仅针对根文件运行 File Watcher，请选择 仅跟踪根文件 复选框。

   • 清除此复选框可针对调用它的文件，以及在指定范围内递归包含该文件的所有文件运行文件监视器。

   请注意， 范围 设置会覆盖 仅跟踪根文件 复选框设置：如果某个依赖项在指定范围之外，将不会对其应用文件监视器。

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

2. 在 实参(A) 字段中，定义传递给工具的参数。

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

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

3. 在 要刷新的输出路径(O) 字段中，指定工具存储其输出结果的文件：生成的源代码、源地图和依赖项。 基于这些设置，CLion 识别通过编译生成的文件。

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

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

4. 展开 工作目录和环境变量 隐藏区域。

5. 定义环境变量。 例如，为 您 正在配置但路径中未引用的工具指定 PATH 变量，其中包含启动该工具所需的工具。 在大多数情况下，它是 Node.js 或 ruby.exe。 这种情况可能是由于使用自定义手动安装而非通过 Node Package Manager (npm) 或 gem manager 进行安装导致的。

6. 在 工作目录(W) 字段中，指定工具将应用到的目录。

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

1. 指定将触发 File Watcher 的事件：

   • 若要在对源代码进行任何更改后立即调用 File Watcher，请选中 自动保存已编辑的文件以触发监视器 复选框。

     清除此复选框后，文件监视器会在保存（文件 | 全部保存 ）时或当您将焦点从 CLion 移开时（框架停用）启动。

     

   • 文件监视器默认在任何已保存的更改时唤醒，包括当您从版本控制系统收到更新时，例如检出分支。 要忽略此类更改并仅在您更新 CLion 中的代码时调用 Watcher，请取消选中 在外部更改时触发监视器 复选框。

2. 指定是否希望 File Watcher 与 CLion 语法解析器进行交互：

   • 当选中 无视语法错误触发监视器 复选框时，文件监视器会在文件语法正确与否的情况下启动。 文件监视器将根据 自动保存已编辑的文件以触发监视器 复选框的状态在更新、保存或框架停用时启动。

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

3. 使用 从 stdout 创建输出文件 复选框来指定您希望如何生成输出文件。

   • 当选中复选框时，CLion 会读取本机工具的输出 standard output stream (stdout) 并生成结果文件。

   • 选中复选框时，该工具会将其输出直接写入 要刷新的输出路径 字段中指定的文件。

4. 在 显示控制台 列表中，选择您希望 File Watcher 何时打开控制台。

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

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

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

• 要启用或禁用文件监视器，请打开 设置 对话框（Ctrl+Alt+S ），转到 工具 | 文件监视器 ，并选中或清除其旁边的复选框。

• 当您打开一个适用于预定义文件监视器的文件时，CLion 会建议启用文件监视器：

  

  border-effect="line" />

• 启用文件监视器后，只要所选类型且位于所选范围内的文件被更改或保存，它就会自动启动，参阅 配置高级选项。

• 如果在 File Watcher 运行时发生错误，将会自动禁用该 File Watcher。 若要恢复状态，请手动启用 File Watcher。

为新项目启用全局文件监视器

Global 文件监视器可以在您将来创建的所有新项目中自动启用。

• 打开 新项目设置 对话框 (文件 | 新项目设置) ，转到 工具 | 文件监视器 ，并选中所需 File Watchers 旁边的复选框。

• 或者，在 欢迎界面 上，从 配置 列表中选择 设置。 在打开的对话框中，选中相关 File Watchers 旁边的复选框。