PyCharm 2026.1 Help

文件和代码模板

PyCharm 会按照 文件模板 中的说明,使用文件模板创建文件。 使用此页面查看、编辑并创建此类模板。

方案

选择文件模板适用的范围:

  • 默认 :在 IDE 级别创建的文件模板。 这些模板在您使用当前 IDE 实例打开的所有项目中均可用。 无论具体项目如何,您都可以将其用作您的个人模板。 PyCharm 将全局模板存储在 IDE 配置目录 中,位置位于 fileTemplates 下。

  • 项目 :特定于当前项目的文件模板。 这些模板对所有参与该项目的人员均可用。 PyCharm 将它们存储在项目文件夹中,位置位于 .idea/fileTemplates 下。

选项卡

PyCharm 包含以下类型的模板:

文件

PyCharm 使用文件模板创建新文件。

包含

这些是可重用片段的模板,可包含到文件模板中。 有关更多信息,请参见 模板中的可复用内容

代码

PyCharm 将这些内置模板用作代码片段,以生成各种结构。

您可以编辑此选项卡上的模板,以修改 PyCharm 生成这些结构的方式,但不能创建新的模板。 若要创建自定义代码片段,请使用 动态模板

工具栏

创建模板按钮创建模板

创建新的 文件包含 模板。

创建子模板文件按钮创建子模板文件​

为所选模板添加子模板,以通过一个模板创建 一组多个文件

删除模板按钮移除模板

删除所选的 文件包含 模板。 您只能删除自定义模板,不能删除默认模板。

复制模板按钮复制模板

创建所选 文件包含 模板的副本。

还原为原始模板按钮还原为原始模板

将所选模板还原为原始状态。 您只能还原已修改的默认模板。

模板设置

名称

指定在 UI 中显示的模板名称。

不适用于默认内置模板。

扩展

指定文件扩展名,以将该模板关联到特定文件类型。

不适用于默认内置模板。

文件名

如有必要,请为从此模板创建的文件指定名称。 默认情况下,PyCharm 在添加文件时会提示用户输入名称。 您可以将特定名称硬编码,以完全避免该提示,或者使用可用变量组合模板。 例如,以下演示了如何使用指定的名称,但将其放在文件创建时所选目录的上一层目录中: ../${NAME}

不适用于默认内置模板。

模板编辑器

编辑所选模板使用的代码。 有关文件模板所用语法的详细信息,请参阅 语法

按照样式重新格式化。

根据为此文件类型定义的 代码风格 ,重新格式化基于此模板生成的内容。

此选项仅适用于文件模板。

启用实时模板

在文件模板中插入 动态模板。 使用 Velocity 转义语法在文件模板中包含 动态模板变量 ,例如: #[[ $MY_VARIABLE$ $END$ ]]#

2026年 3月 24日