Django基础教程（四十八）Django模板语言：Django模板语言入门指南：让你像搭乐高一样玩转网页！

Django模板语言入门指南

最新推荐文章于 2025-11-25 14:10:45 发布

原创最新推荐文章于 2025-11-25 14:10:45 发布 · 322 阅读

3 ·

CC 4.0 BY-SA版权

文章标签：

#django #状态模式 #python

Django基础教程专栏收录该内容

170 篇文章

订阅专栏

嘿，伙计们！今天咱们来聊聊Django模板语言（DTL）——这个让后端程序员也能优雅搞定前端的神奇工具。想象一下，你正在搭乐高：数据是积木块，DTL就是说明书，告诉你每块该放哪。别被“模板语言”这词吓到，它其实就是一套简单到让人笑出来的语法规则！

一、为什么你需要DTL？

在Web开发中，我们经常需要把数据库里的动态数据（比如用户昵称、文章内容）塞进HTML页面。如果纯手写代码，你可能得面对一堆混乱的字符串拼接：

html = "<h1>" + user.name + "</h1><p>" + post.content + "</p>"

这种写法不仅容易出错，还让前端同事想打人！而DTL的解决方案优雅得像在咖啡里加糖：

<h1>{{ user.name }}</h1>
<p>{{ post.content }}</p>

看吧，是不是瞬间清爽了？DTL的核心价值就是：让前端展示和后端逻辑彻底分手，各自安好！

二、DTL核心语法三件套

1. 变量：数据的传送门

变量是DTL里最常用的功能，用双大括号{{ }}包裹。比如后端传递了一个article对象：

# views.py
context = {'article': {'title': 'Python入门', 'views': 100}}

模板里直接调用：

<h2>{{ article.title }}</h2>
<p>阅读量：{{ article.views }}</p>

这就好比把快递包裹（数据）从仓库（后端）直接送到收货人（前端）手里！

特别注意：如果变量不存在，DTL会友好地显示空字符串而不是报错，这个特性让你调试时少掉很多头发。

2. 标签：模板的遥控器

标签用{% %}表示，它能实现循环、判断等高级操作。比如显示文章列表：

<ul>
{% for article in articles %}
    <li {% if forloop.first %}class="first"{% endif %}>
        {{ article.title }} - 第{{ forloop.counter }}篇
    </li>
{% empty %}
    <li>暂无文章，快去写一篇吧！</li>
{% endfor %}
</ul>

这里演示了三个实用技巧：

forloop.first 判断是否为循环首项
forloop.counter 显示当前循环计数
{% empty %} 处理空列表的兜底方案

判断标签同样简单粗暴：

{% if user.role == 'admin' %}
    <button>删除文章</button>
{% elif user.role == 'editor' %}
    <button>编辑文章</button>
{% else %}
    <p>普通用户无法操作</p>
{% endif %}

3. 过滤器：数据的美颜相机

过滤器用竖线|调用，能快速处理变量显示。比如：

<!-- 文本截断 -->
<p>{{ content|truncatewords:10 }}</p>
<!-- 日期格式化 -->
<p>{{ publish_date|date:'Y年m月d日' }}</p>
<!-- 数字四舍五入 -->
<p>{{ rating|floatformat:1 }}分</p>
<!-- 防XSS攻击自动转义 -->
<p>{{ user_input|safe }}</p>

注意最后一个safe过滤器要慎用，它相当于说“我信任这个内容”，就像把家门钥匙交给陌生人！

三、实战：搭建博客页面

让我们用完整示例把知识点串起来。假设我们要做一个博客文章页面：

1. 后端视图（views.py）：

def article_detail(request, article_id):
    article = {
        'title': 'Django模板终极指南',
        'content': '本文深入讲解DTL的各种使用技巧...',
        'pub_date': datetime.now(),
        'views': 156,
        'tags': ['Django', 'Python', 'Web开发']
    }
    return render(request, 'article.html', {'article': article})

2. 模板文件（article.html）：

<!DOCTYPE html>
<html>
<head>
    <title>{{ article.title }}</title>
</head>
<body>
    <article>
        <h1>{{ article.title|upper }}</h1>
        
        <div class="meta">
            <span>发布时间：{{ article.pub_date|date:'Y-m-d' }}</span>
            <span>阅读量：{{ article.views }}</span>
        </div>
        
        <div class="content">
            {{ article.content|linebreaks }}
        </div>
        
        <div class="tags">
            {% for tag in article.tags %}
                <span class="tag">{{ tag }}</span>
                {% if not forloop.last %} | {% endif %}
            {% endfor %}
        </div>
        
        {% if article.views > 100 %}
            <p class="hot">🔥 热门文章！</p>
        {% endif %}
    </article>
</body>
</html>

这个示例展示了：

变量显示（标题、内容）
过滤器应用（转大写、格式化日期、处理换行）
循环输出标签
条件判断显示热门标识

四、高级技巧：模板继承

DTL最强大的功能是模板继承，就像网站的“遗传基因”。先创建基础模板：

base.html：

<!DOCTYPE html>
<html>
<head>
    <title>{% block title %}我的博客{% endblock %}</title>
</head>
<body>
    <header>网站导航栏</header>
    
    <main>
        {% block content %}
        <!-- 留给子模板填充 -->
        {% endblock %}
    </main>
    
    <footer>© 2023 版权所有</footer>
</body>
</html>

子模板通过继承扩展：

{% extends "base.html" %}

{% block title %}{{ article.title }} - 我的博客{% endblock %}

{% block content %}
    <h1>{{ article.title }}</h1>
    <p>{{ article.content }}</p>
{% endblock %}

这就好比你先造好汽车底盘（基础模板），然后根据需要安装不同车身（子模板），效率提升十倍不止！