Django 模板（Template）：告别硬编码，实现动态 HTML页面

IT策士 10余年一线大厂经验专注 IT 思维、架构、职场进阶。当你开始构建一个真正的 Web 应用时很快就会厌倦这种方式def home(request):returnHttpResponse(h1欢迎张三/h1p今天的日期是 2026-05-15/p)这种把 HTML 直接写在 Python 代码里的做法正是典型的硬编码。哪怕只改动一个标点都要修改视图代码、重启服务器。而当页面结构变复杂时代码会变成一团糟毫无可维护性可言。Django 的模板Template系统正是为了解决这个问题而生的。它让你把 HTML 页面独立出来只负责展示逻辑而数据则由视图View动态注入。这就是MTV 模式中 TTemplate的核心价值。1. 初识 Django 模板配置与第一个模板首先要确保项目已配置好模板引擎。打开settings.py你会看到类似配置TEMPLATES[{BACKEND:django.template.backends.django.DjangoTemplates,DIRS:[BASE_DIR /templates],# 全局模板目录APP_DIRS:True,# 自动查找每个应用下的 templates 目录OPTIONS:{context_processors:[django.template.context_processors.debug,django.template.context_processors.request,django.contrib.auth.context_processors.auth,django.contrib.messages.context_processors.messages,],},},]接着在应用目录比如blog下创建templates/blog/index.html!DOCTYPE htmlhtmlheadmetacharsetutf-8title{{title}}/title/headbodyh1欢迎{{user_name}}/h1p今天的日期是{{today}}/p/body/html视图中使用render()将数据传入模板from django.shortcutsimportrender from datetimeimportdatedef home(request): context{title:我的博客,user_name:张三,today:date.today(),}returnrender(request,blog/index.html, context)访问页面你会看到动态生成的 HTML。我们还可以在 Django shell 中直接体验模板的渲染过程感受它的底层运作from django.templateimportTemplate, ContexttTemplate(h1欢迎{{ user_name }}/h1)cContext({user_name:李四})print(t.render(c))h1欢迎李四/h1控制台输出正是你看到的最后一行 HTML 字符串。这就是模板的本质把上下文数据填充到占位符中生成纯静态 HTML 返回给浏览器。2. 三大核心语法变量、标签、过滤器Django 模板的语法集中体现在三种特殊标记上。2.1 变量 ——{{ variable }}变量用双大括号包裹模板会将其替换为上下文中的对应值。变量名支持点号查找比如访问字典键、对象属性和列表索引# 视图传入context{book:{title:Django 实战,author:王五},numbers:[10,20,30],}p书名:{{book.title}}/pp作者:{{book.author}}/pp第二个数字:{{numbers.1}}/p在 shell 中验证tTemplate(书名: {{ book.title }}, 作者: {{ book.author }})cContext({book:{title:深入浅出Django,author:老张}})print(t.render(c))书名: 深入浅出Django, 作者: 老张2.2 标签 ——{% tag %}标签用来实现逻辑控制比如循环、条件判断、URL 生成等。常用的有for 循环ul{%forarticleinarticles %}li{{article.title}}——{{article.author}}/li{% empty %}li暂无文章/li{% endfor %}/ul如果articles是空列表会执行{% empty %}下的内容。视图模拟数据并打印结果from django.templateimportTemplate, ContexttTemplate(...ul...{%forartinarticles %}...li{{art.title}}/li...{% empty %}...li无数据/li...{% endfor %}.../ul...)cContext({articles:[{title:Django入门},{title:模板进阶}]})print(t.render(c).strip())ulliDjango入门/lili模板进阶/li/ulif/elif/else 条件判断{%ifuser.is_authenticated %}p欢迎回来{{user.username}}/p{%elifuser.is_anonymous %}p请先登录/p{%else%}p用户状态未知/p{% endif %}在 shell 里测试多个分支tTemplate({% if score 90 %}优秀{% elif score 60 %}及格{% else %}不及格{% endif %})print(t.render(Context({score:85})))及格print(t.render(Context({score:55})))不及格url 标签避免在模板中硬编码 URL 路径使用命名路由ahref{% url blog:detail article.id %}阅读全文/ablog:detail是你在urls.py中定义的 name 参数即使将来 URL 变化模板也无需修改。csrf_token在任何有 POST 表单的模板中必须添加formmethodpost{% csrf_token %}!-- 表单内容 --/form它会生成一个隐藏的 CSRF 令牌防止跨站请求伪造攻击。2.3 过滤器 ——{{ variable|filter }}过滤器就像一个小函数对变量进行加工后再显示。可以串联使用{{ text|truncatewords:30|safe }}。常用过滤器及控制台演示from django.templateimportTemplate, Context# 1. date 格式化日期tTemplate({{ today|date:Y年m月d日 }})importdatetimeprint(t.render(Context({today:datetime.date(2026,5,15)})))2026年05月15日# 2. default 默认值tTemplate(昵称: {{ nickname|default:匿名用户 }})print(t.render(Context({})))# 没传 nickname昵称: 匿名用户# 3. length 获取长度tTemplate(标签数: {{ tags|length }})print(t.render(Context({tags:[Python,Django,Web]})))标签数:3# 4. truncatechars 截断字符tTemplate(简介: {{ desc|truncatechars:10 }})print(t.render(Context({desc:这是一篇很长很长的文章介绍})))简介: 这是一篇很长...# 5. safe 标记安全内容慎用tTemplate({{ html_text|safe }})print(t.render(Context({html_text:strong加粗/strong})))strong加粗/strong# 实际 HTML 会被执行注意safe会关闭自动转义存在 XSS 风险只应对可信内容使用。3. 模板继承消除重复代码真实项目中所有页面往往共享相同的头部、导航栏、侧边栏和底部。Django 的模板继承让你只需定义一个基础骨架其他页面按需填充。基础模板base.html!DOCTYPE htmlhtmlheadtitle{% block title %}我的网站{% endblock %}/title{% block extra_head %}{% endblock %}/headbodyheadernav首页|文章|关于/nav/headermain{% block content %}!-- 子模板内容会出现在这里 --{% endblock %}/mainfooter©2026我的网站/footer/body/html子模板blog/list.html{% extendsbase.html%}{% block title %}{{category.name}}- 文章列表{% endblock %}{% block content %}h1分类{{category.name}}/h1{%forpostinposts %}articleh2{{post.title}}/h2p{{post.summary|truncatewords:30}}/p/article{% empty %}p该分类下暂无文章。/p{% endfor %}{% endblock %}在 shell 中我们无法直接测试继承因为需要加载模板文件但可以在视图中通过render观察效果。更直观的方式是编写一个小的视图并查看控制台输出或直接看浏览器。不过我们可以模拟块覆盖的思路# 模拟 base.html 定义baseTemplate( 开始{% block main %}默认{% endblock %}结束)# 模拟子模板内容实际上 extends 会触发模板加载# 这里仅做概念说明真实项目中使用文件系统加载器。概念清晰即可继承让代码复用率大幅提升新增页面只需关注变化的内容块。4. 包含与复用组件 ——{% include %}除了继承还可以用{% include %}把独立的 UI 片段如分页条、评论区抽离成组件在多个模板中引用。定义_pagination.htmldivclasspagination{%ifpage_obj.has_previous %}ahref?page{{ page_obj.previous_page_number }}上一页/a{% endif %}span第{{page_obj.number}}/{{page_obj.paginator.num_pages}}页/span{%ifpage_obj.has_next %}ahref?page{{ page_obj.next_page_number }}下一页/a{% endif %}/div在列表页中使用{% include_pagination.htmlwithpage_objpage_obj %}with可以传递额外的变量。如果不写模板会自动访问当前上下文中的同名变量。还可以传递固定值{% includename_card.htmlwithpersonusergreeting你好%}5. 实战构建一个动态博客首页现在我们把学到的知识整合实现一个简单的博客首页显示文章列表、分类、用户登录状态。视图views.pyfrom django.shortcutsimportrender from datetimeimportdatedef blog_home(request):# 模拟数据库数据posts[{id:1,title:深入理解Django模板,summary:讲解模板语法...,pub_date:date(2026,5,10)},{id:2,title:Python 3.13 新特性,summary:关于新版本...,pub_date:date(2026,5,12)},]categories[Django,Python,前端]userrequest.user# 当前登录用户context{posts:posts,categories:categories,user:user,}# 打印上下文数据方便调试print(首页上下文数据, context)returnrender(request,blog/home.html, context)控制台会输出首页上下文数据{posts:[{id:1,title:深入理解Django模板,...},...],categories:[Django,Python,前端],user:SimpleLazyObject:User: admin}模板blog/home.html{% extendsbase.html%}{% block title %}博客首页{% endblock %}{% block content %}h1最新文章/h1!-- 用户状态 --{%ifuser.is_authenticated %}p你好{{user.username}}ahref/accounts/logout/退出/a/p{%else%}pahref/accounts/login/登录/a|ahref/accounts/register/注册/a/p{% endif %}!-- 分类导航 --divclasscategoriesstrong分类/strong{%forcatincategories %}ahref#{{cat}}/a{%ifnot forloop.last %},{% endif %}{% endfor %}/div!-- 文章列表 --{%forpostinposts %}articleh2ahref{% url blog:detail post.id %}{{post.title}}/a/h2pclassdate{{post.pub_date|date:Y年m月d日}}/pp{{post.summary|truncatewords:20}}/p/article{% empty %}p还没有文章赶紧写一篇吧。/p{% endfor %}!-- 包含分页组件示例无实际分页对象 --{% comment %}{% include_pagination.html%}{% endcomment %}{% endblock %}这个首页完全由数据驱动结构与展示分离。今后你只需要修改视图中的posts数据来源例如从数据库查询模板无需变动。6. 进阶技巧自定义过滤器与标签当内置过滤器无法满足需求时你可以创建自己的模板工具。6.1 自定义过滤器在应用目录下创建templatetags包含__init__.py新建blog_extras.pyfrom djangoimporttemplateimportbleach registertemplate.Library()register.filter(nametruncate_chinese)def truncate_chinese(value,max_length30):智能截断中文字符避免乱码iflen(value)max_length:returnvaluereturnvalue[:max_length]...register.filter def add_class(value, css_class):为表单字段添加 CSS 类简化版returnvalue.as_widget(attrs{class:css_class})在模板中加载并使用{% load blog_extras %}p{{post.content|truncate_chinese:50}}/p{{form.username|add_class:form-control}}控制台里直接测试自定义过滤器from django.templateimportTemplate, Context# 先确保加载了标签库在实际 shell 中需要先注册 app# 模拟效果def truncate_chinese(value,max_len10):...returnvalue[:max_len]...iflen(value)max_lenelsevalue...tTemplate({% load blog_extras %}{{ text|truncate_chinese:6 }})# 实际渲染需要模板引擎加载这里仅示意...6.2 自定义包含标签如果某个片段需要一些 Python 逻辑才能渲染可以用包含标签。比如“最新评论”组件register.inclusion_tag(blog/latest_comments.html)def show_latest_comments(post_id,count5): commentsComment.objects.filter(post_idpost_id).order_by(-created)[:count]return{comments:comments}模板latest_comments.htmlul{%forcommentincomments %}li{{comment.author}}:{{comment.content|truncatechars:30}}/li{% endfor %}/ul使用时{% show_latest_comments post.id3%}7. 模板调试与最佳实践7.1 控制台输出助力调试开发过程中你可以在视图中使用print()查看传入模板的上下文或者查看某个对象的类型和属性def article_list(request): postsPost.objects.prefetch_related(tags).all()print(查询到的文章数量, posts.count())forpinposts: print(p.title, p.tags.all())returnrender(request,list.html,{posts:posts})服务器控制台将实时输出这些信息方便你核对数据是否符合预期。7.2 利用 Django Debug Toolbar安装django-debug-toolbar它会在页面侧边栏展示模板渲染的上下文、SQL 查询等信息比 print 更为强大。7.3 模板设计原则逻辑尽量简单模板中只放展示逻辑复杂的业务逻辑应放在视图或模型中。避免大量嵌套利用继承和包含拆分复杂页面。静态资源管理使用{% static css/style.css %}引用静态文件。安全性不要轻易使用safe过滤器确保转义输出时刻记住{% csrf_token %}。8. 总结Django 模板让你从硬编码 HTML 的泥潭中解脱实现了表现与逻辑分离HTML 独立为模板文件Python 代码专注数据处理。代码复用通过继承和包含公共部分只写一次。可维护性修改页面结构时无需触碰视图代码反之亦然。高度可扩展自定义标签和过滤器能满足各种个性化需求。从最简单的{{ variable }}开始到构建出结构清晰的动态网站模板系统始终是 Django 快速开发理念的基石。掌握它你就能优雅地“告别硬编码实现动态 HTML 页面”。还可以去公众号、今日头条搜索「IT策士」一起升级 IT 思维