PyCharm 2025.3 Help

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

启用 Django 插件

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

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

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

借助 Django,您可以设置一个新标签,引入内置模板标签未涵盖的功能。 PyCharm 为您提供相应的代码和导航帮助。

创建自定义模板标签

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

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

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

    添加自定义模板标签

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

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

    未解析的引用

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

  2. 使用 快速修复 以解决缺少的引用。 将插入符号置于自定义标签名称处,按 Alt+Enter ,然后选择要加载的文件。

    用于加载自定义模板的检查

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

    模板标签实现名称补全

此外,PyCharm 也会识别在 settings.py 文件的 TEMPLATES 部分中作为 builtins 标签记录的自定义模板标签。

导航到模板标签的实现

在设置文件中记录自定义标签后,您可以导航到其声明所在的文件。 将插入符号置于模板标签文件名处,然后按 Ctrl+B

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