PyCharm 2025.3 Help

文件和代码模板

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

方案

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

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

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

选项卡

PyCharm 包含以下类型的模板:

文件

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

Include

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

代码

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

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

工具栏

创建模板按钮创建模板

创建新的 文件包含 模板。

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

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

删除模板按钮移除模板

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

复制模板按钮复制模板

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

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

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

模板设置

名称(N)

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

不适用于默认内置模板。

扩展(E)

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

不适用于默认内置模板。

文件名

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

不适用于默认内置模板。

模板编辑器

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

按照样式重新设置格式(R)

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

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

启用实时模板(L)

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

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