PyCharm 2025.2 Help

创建并使用自定义模板标签

启用 Django 插件

此功能依赖于 Django 插件,该插件默认情况下已捆绑并在 PyCharm 中启用。 如果相关功能不可用,请确保没有禁用该插件。

  1. 按下 Ctrl+Alt+S 打开设置,然后选择 插件

  2. 打开 已安装 选项卡,找到 Django 插件,并选中插件名称旁边的复选框。

使用 Django,您可以设置一个新标签来引入内置模板标签未涵盖的功能。 PyCharm 为您提供了相应的代码和导航支持。

创建自定义模板标签

  1. 在应用程序目录下,创建 templatetags package (它应包含 __init__.py 文件)。 例如, Django/DjangoApp/templatetags

  2. templatetags 包中,创建一个 .py 文件,例如 my_custom_tags ,并向其中添加一些代码以声明自定义标签。

    有关 自定义模板标签 编码实践的更多信息,请参阅 Django 文档。

    添加自定义模板标签

将自定义模板标签添加到模板

  1. 在编辑器中打开您的模板文件,并向其中添加相应的模板标签。

    未解析的引用

    PyCharm 显示 Unresolved tag 检查错误,因为您尚未将自定义标签加载到模板文件中。

  2. 使用 快速修复 解决缺失的引用。 将光标放在自定义标签名称上,按 Alt+Enter ,然后选择要加载的文件。

    加载自定义模板的检查

    PyCharm 将 {% load %} 标签添加到模板文件中以修复引用。

    标签实现名称补全

PyCharm 还会识别记录为 builtins 标签的自定义模板标签,这些标签位于 TEMPLATES 部分的 settings.py 文件中。

导航到标签实现

一旦您在设置文件中记录了自定义标签,您就可以导航到其声明所在的文件。 将光标放在模板标签文件名上,然后按 Ctrl+B

最后修改日期: 2025年 9月 26日