Django模板系统详解：从基础语法到高级应用-代码聚汇网

Django模板系统详解：从基础语法到高级应用

DR阿福·2026-05-08·阅读 40 GEO检测（免费）

Django模板DTL语法模板继承

|难度：普通|阅读约 43 分钟

1. Django模板系统概述

Django模板系统是Django框架中用于分离业务逻辑和展示逻辑的核心组件。作为一个全栈开发者，我使用Django模板系统已有8年时间，见证了它从简单变量替换到如今功能完备的模板引擎的演进过程。

模板系统的基本工作原理是将模板文件（通常是.html文件）与上下文数据结合，生成最终的HTML输出。这种分离设计让前端开发者和后端开发者能够并行工作，也使得项目更易于维护。在实际项目中，我见过太多因为模板使用不当导致的维护噩梦，所以理解模板系统的每个细节至关重要。

Django模板语言（DTL）是专门为Django设计的，它足够简单让非程序员也能理解，又足够强大能满足复杂需求。与Jinja2等其他模板引擎相比，DTL更强调"显式优于隐式"的原则，这虽然有时显得啰嗦，但大大降低了调试难度。

提示：Django官方文档建议优先使用DTL而非第三方模板引擎，除非有特殊需求。我在多个大型项目中验证过这一建议的合理性。

需要模型API调用？免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。

2. 模板基础语法解析

2.1 变量与过滤器

变量是模板系统最基本的元素，使用双大括号表示：{{ variable }}。当模板引擎遇到这种语法时，它会按照以下顺序查找变量：

字典查找（如{{ dict.key }}）
属性查找（如{{ object.attribute }}）
方法调用（无参数方法，如{{ object.method }}）
列表索引查找（如{{ list.0 }}）

过滤器可以修改变量的显示，使用管道符号|连接。Django内置了60多个过滤器，常用的有：

django复制{{ name|lower }}  <!-- 转换为小写 -->
{{ bio|truncatewords:30 }}  <!-- 截断前30个单词 -->
{{ value|default:"nothing" }}  <!-- 默认值 -->

我在实际项目中最常用的几个过滤器组合：

{{ date|date:"Y-m-d"|default:"-" }} 格式化日期并设置默认值
{{ content|striptags|truncatechars:100 }} 去除HTML标签后截断

2.2 标签系统

标签提供了模板逻辑控制能力，使用{% tag %}语法。最重要的几个标签：

for循环：

django复制{% for item in item_list %}
    <li>{{ forloop.counter }}: {{ item.name }}</li>
{% empty %}
    <li>暂无数据</li>
{% endfor %}

if条件：

django复制{% if user.is_authenticated %}
    Welcome, {{ user.username }}.
{% elif anonymous_welcome %}
    Please login.
{% else %}
    Access denied.
{% endif %}

with缓存变量：

django复制{% with total=business.employees.count %}
    {{ total }} employee{{ total|pluralize }}
{% endwith %}

注意：过度复杂的模板逻辑是常见反模式。我的经验法则是：如果模板中有超过3层嵌套的if或for，就应该考虑将逻辑移到视图或自定义模板标签中。

3. 模板继承与组件化

3.1 模板继承机制

Django模板继承是DRY（Don't Repeat Yourself）原则的完美体现。基本结构如下：

base.html:

django复制<!DOCTYPE html>
<html>
<head>
    <title>{% block title %}默认标题{% endblock %}</title>
</head>
<body>
    {% block content %}{% endblock %}
</body>
</html>

child.html:

django复制{% extends "base.html" %}

{% block title %}子页面标题{% endblock %}

{% block content %}
    <h1>这是内容区域</h1>
{% endblock %}

我在大型项目中总结的最佳实践：

创建3层继承结构：base.html → section_base.html → page.html
使用{{ block.super }}调用父模板内容
为CSS/JS资源定义多个block（如extra_css, footer_js）

3.2 包含与组件化

{% include %}标签用于引入子模板，实现组件复用：

django复制{% include "components/header.html" with title=page_title only %}

参数说明：

with传递上下文变量
only限制只传递指定变量（避免意外变量泄漏）

我常用的组件化方案：

将导航栏、页脚等拆分为独立组件
为复杂表单字段创建专用模板（如form_field.html）
使用only参数严格控制变量作用域

4. 高级模板特性

4.1 自定义过滤器和标签

当内置功能不足时，可以创建自定义过滤器和标签。这是我的标准实现步骤：

在app中创建templatetags目录和__init__.py文件
创建模块文件（如custom_tags.py）
注册并使用：

python复制from django import template

register = template.Library()

@register.filter
def add_str(value, arg):
    """连接字符串"""
    return f"{value}-{arg}"

@register.simple_tag
def current_time(format_string):
    return datetime.now().strftime(format_string)

模板中使用：

django复制{% load custom_tags %}
{{ 'hello'|add_str:'world' }}  <!-- 输出：hello-world -->
{% current_time "%Y-%m-%d" %}  <!-- 输出当前日期 -->

4.2 模板性能优化

模板渲染可能成为性能瓶颈，特别是在循环中。我常用的优化技巧：

使用{% with %}缓存重复查询
在视图层预计算复杂值
对静态内容使用{% static %}标签
启用模板缓存：

python复制TEMPLATES = [{
    'BACKEND': 'django.template.backends.django.DjangoTemplates',
    'DIRS': [],
    'OPTIONS': {
        'loaders': [
            ('django.template.loaders.cached.Loader', [
                'django.template.loaders.filesystem.Loader',