专业的

文件观察者

1. 在“设置”对话框 ( ) 中，单击“工具”下的“文件观察器”。文件观察器页面打开，显示已在此项目和 IDE 中配置的文件观察器列表。CtrlAlt0S

2. 单击并选择要从中创建文件观察器的预定义模板。选择取决于您要使用的工具。要使用列表中未列出的工具，请选择“自定义”。“新建观察程序”对话框打开。

3. 在“名称”字段中，输入文件观察器的名称。默认情况下，PyCharm 建议所选预定义模板的名称。

1. 从文件类型列表中，选择所需的输入文件类型。文件观察器将仅考虑这种类型的文件作为分析和处理的主题。文件类型是根据文件类型和文件扩展名之间的关联来识别的。

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

2. 选择文件观察器适用的范围。

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

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

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

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

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

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

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

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

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

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

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

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

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

3. 可选：指定您希望文件观察器如何处理依赖项。根文件是指未包含（例如通过）指定范围内import任何其他文件的文件。

   • 要仅针对根文件运行文件观察器，请选中“仅跟踪根文件”复选框。

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

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

   笔记

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

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

   提示

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

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

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

2. 在参数字段中，定义要传递给工具的参数。

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

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

   提示

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

   • 使用空格作为分隔符。

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

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

3. 在刷新的输出路径字段中，指定工具存储其输出的文件：生成的源代码、源映射和依赖项。基于这些设置，PyCharm 识别通过编译生成的文件。

   笔记

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

   输出路径通常使用宏来指定。手动输入路径或单击并从列表中选择相关模式。

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

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

6. 在工作目录字段中，指定将应用该工具的目录。

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

   提示

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

1. 指定将调用文件观察器的事件：

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

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

   • 默认情况下，文件观察器会在任何保存的更改时唤醒，包括当您签出分支时从版本控制系统收到的更新。要忽略此类更改并仅在更新 PyCharm 中的代码时调用文件观察器，请清除“外部更改触发观察器”复选框。

2. 指定是否希望文件观察器与 PyCharm 语法解析器交互：

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

   • 当清除“无论语法错误如何触发观察器”复选框时，文件观察器将忽略语法无效的文件中的所有触发器，并且仅在无错误的文件中启动。

3. 使用“从标准输出创建输出文件”复选框指定生成输出文件的方式。

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

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

4. 在“显示控制台”列表中，选择您希望文件观察器打开控制台的时间。

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

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

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

• 要启用或禁用文件观察器，请打开“设置”对话框 ( )，然后转至“工具”|“文件观察器”。文件观察者，然后选择或清除它旁边的复选框。CtrlAlt0S

  启用文件观察器后，一旦更改或保存选定类型和选定范围内的文件，它就会自动启动，请参阅配置高级选项。

  如果文件观察程序运行时发生错误，文件观察程序将自动禁用。要恢复状态，请手动启用文件观察器。

保存时自动运行文件观察程序

您可以将 IDE 配置为在保存更改时自动运行修改文件中的文件观察程序。

1. 按打开 IDE 设置，然后选择“工具”|“IDE”。保存操作。CtrlAlt0S

2. 启用文件观察器选项并应用更改。