专业的

新观察者对话框

文件类型

使用此列表指定预期的输入文件类型。文件观察器将仅考虑这种类型的文件作为分析和处理的主题。文件类型是根据文件类型和文件扩展名之间的关联来识别的。

提示

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

范围

使用此列表可以定义文件观察器可以应用的文件范围。

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

从列表中选择预定义范围之一。对于项目级文件观察器，您还可以在打开的“范围”对话框中单击以配置自定义范围。

• 所有地点：下面列出的所有范围。

• 项目文件：项目内容根内的所有文件（请参阅 配置项目结构）。

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

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

• Scratches and Consoles：项目工具窗口中Scratches and Consoles目录中的所有文件。

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

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

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

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

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

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

提示

仅跟踪根文件

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

• 选中此复选框后，文件观察器仅针对根文件运行。

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

请注意，“范围”设置会覆盖“仅跟踪根文件”复选框设置：如果依赖项超出指定范围，则不会对其应用文件观察器。

示例假设您有两个文件root.scss和another.scss，其中root.scss导入another.scss。选中“仅跟踪根文件”复选框后，编辑another.scss只会在root.scss上调用文件观察器。否则，如果清除该复选框，文件观察器将处理这两个文件。

提示

此选项仅适用于Babel、Closure Compiler、Jade、Less、Sass / SCSS、Stylus和UglifyJS。

程序

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

提示

• 要使用程序文件名而不是文件名路径，请将其文件夹的路径添加到系统环境变量 PATH 中。

• 在 Windows 上，您可以跳过.com、.exe、.cmd或.bat扩展名。

• 要使用jar存档，请指定它的绝对路径。或者，要使用相对路径，请将其父文件夹添加到外观和行为 |上的PyCharm 路径变量中。IDE 设置的 Path Variables页面。CtrlAlt0S

论点

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

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

手动键入宏或单击并从打开的“宏”对话框的列表中选择相关模式。

提示

指定参数时，请遵循以下规则：

• 使用空格作为分隔符。

• 如果参数包含空格，请将它们或整个参数括在双引号中：some" "arg或"some arg"。

• 如果参数包含双引号，请使用反斜杠对其进行转义：-Dmy.prop=\"quoted_value"\。

刷新的输出路径

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

输出路径通常使用宏来指定。您可以手动输入它们，也可以单击并从打开的对话框的列表中选择相关的。

笔记

更改刷新输出路径字段中的值不会使该工具将其输出存储在其他位置。如果您仍然需要这样做，请在“参数”字段中指定所需的自定义输出位置：输入以冒号作为分隔符的输出路径并使用宏。

工作目录

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

提示

如果将工作目录字段留空，PyCharm 将使用调用文件观察器的文件目录。

环境变量

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

自动保存编辑的文件以触发观察者

• 选中此复选框后，PyCharm 在您编辑文件后立即保存文件，以便文件观察器立即唤醒。

• 清除该复选框后，文件观察器会在保存（文件 | 全部保存）时或当您将焦点从 PyCharm 移开时启动（在帧停用时）。

触发外部变化的观察者

• 选中此复选框后，文件观察器会在文件范围内对文件进行任何更改时唤醒，包括在 PyCharm 外部进行的更改或在版本控制系统中检出分支后进行的更改。

• 清除该复选框后，文件观察器仅在从 PyCharm 更新其范围内的文件时启动，并忽略其他更改，例如从版本控制系统收到的更改。

无论语法错误如何都会触发观察程序

• 选中该复选框后，无论文件的语法正确性如何，文件观察器都会启动。文件观察器将在更新、保存或框架停用时启动，具体取决于自动保存编辑的文件以触发观察器复选框的状态。

• 清除此复选框后，文件观察器会忽略语法上无效的文件中的所有触发器，并仅在无错误的文件中启动。

从标准输出创建输出文件

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

• 选中此复选框后，PyCharm 会读取本机工具的输出standard output stream (stdout)并从中生成结果文件。生成的文件的名称取自“刷新的输出路径”字段。如果该字段包含多个名称，则使用列表中的第一个名称。

显示控制台

从此列表中，选择您希望文件观察器打开控制台的时间。

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

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

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

输出滤波器

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

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