不用每个模板都写loaddjango-template-partials全局builtins配置技巧【免费下载链接】django-template-partialsReusable named inline partials for the Django Template Language.项目地址: https://gitcode.com/gh_mirrors/dj/django-template-partialsDjango 开发者一定遇到过这样的场景为了复用一段模板代码每个模板文件开头都要写上{% load partials %}模板一多就变得又啰嗦又容易遗漏。django-template-partials 正是为解决 Django 模板语言DTL中可复用命名内联 partials而生的开源库配合 Django 模板引擎的 builtins 配置你可以在项目里彻底告别重复的 load 语句。这篇文章就带你从零掌握这个全局配置技巧让模板代码更清爽、维护更省心。django-template-partials 是什么为什么值得用django-template-partials 是 Django 模板语言的一个扩展库核心能力是让你在同一个模板文件内部定义可复用的命名片段partial然后在当前模板中多次调用甚至可以直接通过模板加载器单独渲染某一段。它解决了模板复用中的三个痛点✅ 不需要把公共片段拆成独立文件再用{% include %}引入代码就近维护✅ 同一个片段可以在一页里重复渲染还支持在循环中正常工作✅ 支持example.html#片段名的加载方式视图层可以直接只渲染某一段更重要的是Django 官方从 6.0 起已原生支持模板 partials这个库的历史版本5.x 以下依然是大量存量项目的首选而且它对 Django 4.2 ~ 6.0 全版本兼容迁移成本极低。第一步快速安装 django-template-partials先用 pip 安装依赖再把它注册到INSTALLED_APPS两步就完成pip install django-template-partialsINSTALLED_APPS [ template_partials, # ... 其他应用 ]注册后库会自动为你配置好模板加载器loader.py 中的Loader支持模板名#片段名的局部渲染无需手动干预。想从源码研究或二次开发也可以克隆仓库git clone https://gitcode.com/gh_mirrors/dj/django-template-partials第二步先认识 partialdef 与 partial 标签在配置全局 builtins 之前我们先看看这个库的基本用法。假设要复用一段卡片 HTML{% load partials %} {% partialdef user-card %} div classcard h3{{ user.name }}/h3 p{{ user.email }}/p /div {% endpartialdef %} {% block main %} {% for user in users %} {% partial user-card %} {% endfor %} {% endblock %}核心只有三个标签标签作用{% partialdef 名称 %}定义命名的可复用片段{% endpartialdef %}结束定义可写{% endpartialdef 名称 %}增加可读性{% partial 名称 %}在任意位置渲染该片段片段会继承当前上下文所以在{% for %}循环里可以按预期工作也可以用{% with %}临时调整上下文后再渲染。第三步核心技巧——把 partials 加入模板引擎 builtins问题来了如果每个模板都要写{% load partials %}那和直接写{% include %}的区别就被削弱了。全局 builtins 配置就是让你一劳永逸的终极方案。Django 模板引擎的OPTIONS支持builtins参数其中的模板标签库会自动为所有模板加载。把 partials 标签库加进去所有模板都能直接使用partialdef/partial无需任何 load# settings.py TEMPLATES [ { BACKEND: django.template.backends.django.DjangoTemplates, DIRS: [BASE_DIR / templates], APP_DIRS: True, OPTIONS: { builtins: [template_partials.templatetags.partials], # ... 其他配置 }, }, ]配置完成后模板里直接写{% partialdef footer-partial %} footer© 2026 我的站点/footer {% endpartialdef %} {% block content %} 文章正文…… {% partial footer-partial %} {% endblock %}再也不用写{% load partials %}了 这一行配置能让项目里所有模板立刻继承partials 能力新同事写模板也不会因为漏写 load 而报Invalid block tag错误。 小贴士builtins同样适用于把{% load static %}、自定义过滤器等高频标签全局化一个配置解决 N 个烦恼。第四步多引擎与高级配置方法如果你的项目有多个模板引擎比如同时用 DTL 和 Jinja2只想给其中一个配置 builtins也很简单——在每个引擎各自的OPTIONS.builtins里分别配置即可。如果出于特殊原因不想让INSTALLED_APPS里的template_partials自动包装模板加载器可以使用SimpleAppConfig自己接管INSTALLED_APPS [ template_partials.apps.SimpleAppConfig, # ... ]然后手动为指定后端启用 partials 加载器wrap_loaders 定义from template_partials.apps import wrap_loaders TEMPLATES [ { BACKEND: django.template.backends.django.DjangoTemplates, NAME: myname, # ... }, ] wrap_loaders(myname)如果没写NAME库会取BACKEND的倒数第二段作为名称例如django.template.backends.django.DjangoTemplates对应django大多数情况下无需额外指定。第五步实战场景——include 与视图层局部渲染配置好 builtins 后还有一个隐藏福利partials 与加载器深度集成你可以用模板名 片段名的方式做局部渲染。在视图中self.template_name example.html#user-card在模板中{% include example.html#user-card %}这样include就不再是引入整个文件而是只渲染文件里的某一段代码组织更精细。官方测试模板 example.html 就是同时使用重复渲染与 inline 输出的完整示例值得参考。常见问题与避坑清单Django 6.0 用户注意6.0 起 partials 已进入 Django 核心此库会给出 DeprecationWarning 提示你迁移可参考项目内的 Migration.md 平滑升级。builtins 配置后仍报错确认INSTALLED_APPS里已加入template_partials且模板引擎使用的是DjangoTemplates后端。片段未定义{% partial 名称 %}必须在同一模板或通过加载器中能找到对应{% partialdef %}否则会抛TemplateSyntaxError。inline 参数如果希望片段定义处直接输出内容用{% partialdef xxx inline %}适合包裹现有页面区域。总结一行配置解放所有模板方式每个模板都要写全局配置普通用法{% load partials %}✅无需写 ✅builtins 配置无需写 ✅无需写 ✅出错概率漏写 load 报错几乎为零django-template-partials 的 builtins 全局配置是一次配置、全站受益的典型技巧。它让模板片段复用从记得 load变成天生可用尤其适合模板数量多、多人协作的中大型 Django 项目。花一分钟改配置换来的是长期整洁的模板代码——这笔账怎么算都划算。【免费下载链接】django-template-partialsReusable named inline partials for the Django Template Language.项目地址: https://gitcode.com/gh_mirrors/dj/django-template-partials创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考