PyCharm 2025.3 Help

活动模板

使用此页面创建、管理并编辑 活动模板

主要设置

项目

描述

默认展开方式

指定所有模板的默认调用键。 单个模板的展开键在 编辑区域 中定义。

如果标准展开键(TabEnterSpace )不合适,请在此列表中选择 自定义 选项。

选择 自定义 后,下拉列表旁会显示 更改 链接,将您带到 键位映射 页面。

实时模板

显示当前可用的所有模板缩写及其描述。 缩写按节点分组,并在每个组内按字母顺序排序。 要激活某个模板或整个组,请选中模板或组旁边的复选框。

添加图标

添加 Alt+Insert

向当前模板组添加一个新的模板项。 您可以在编辑区域 下方 定义模板缩写、描述、文本、变量、展开键和上下文。

移除图标

移除 Delete

从列表中移除所选活动模板。

创建副本图标

复制

点击此按钮,可基于所选模板创建新模板。 将在当前节点添加一个新的模板项,模板文本区域中的字段显示所选模板的定义。

恢复已删除默认项图标

还原已删除的默认模板

点击此按钮可恢复已删除的活动模板。 此按钮仅在应用更改后才会启用。

活动模板的上下文菜单

项目

描述

移动

将所选模板移动到指定组。

更改上下文

更改当前模板启用的上下文。 选择此命令时,会显示受支持的语言上下文列表。 要使 PyCharm 将某个上下文视为对该模板敏感,请选中上下文名称旁的复选框。

可用上下文类型取决于已启用的插件。

复制

在系统剪贴板中创建 序列化模板 XML

粘贴

已复制的模板 的 XML 表示粘贴到所选模板组中。

恢复默认设置

此命令仅出现在已修改模板(以蓝色标记)的上下文菜单中。 选择此命令以恢复模板的默认设置。

模板编辑区域

在以下情况下,焦点将移动到此区域:

  • 当您点击 添加 添加图标复制 复制图标 按钮时。

  • 当您在列表中选择一个活动模板时。

  • 当您在编辑器中选择一段代码并选择 代码 | 保存为实时模板 时。

使用此区域中的控件来创建新的 活动模板 并编辑现有模板的设置。

您可以使用字段标签中标注的快捷键在模板文本区域中导航。

项目

描述

缩写

在此字段中指定模板缩写。 例如,在编辑器中标识该模板的一串字符。

描述

在此字段中,提供模板的可选描述或其用法示例。

模板文本

在此字段中,输入模板主体,该主体可以包含纯文本和格式为 $<variable name>$ 的变量。 如有必要,点击 编辑变量 ,并根据需要 配置变量。 要在模板文本中转义美元符号 $ ,只需将其加倍 $$

适用范围

此只读字段显示编辑器应对该模板敏感的语言和代码片段。 在此类上下文中按下 Ctrl+J 后, PyCharm 会显示对此上下文有效的模板列表。

更改

点击此链接以修改当前模板启用的上下文集合。 点击该链接后,会显示受支持的语言上下文列表。 要使 PyCharm 将某个上下文视为对该模板敏感,请选中上下文名称旁的复选框。

可用上下文类型取决于已启用的插件。

编辑变量

打开 编辑模板变量 对话框,您可以在其中定义 PyCharm 在展开模板时应如何处理模板变量。 有关详细信息,请参阅 动态模板变量

选项

在此区域,定义模板展开时编辑器的行为。

  • 展开方式(X) - 从此列表中选择用于调用模板的按键。

  • 按照样式重新设置格式(R) :选中此复选框,可使 PyCharm 根据在 代码样式页面 上定义的当前样式设置自动重新格式化展开的文本。

工作原理

最后修改日期: 2025年 12月 2日