Django开发：模板系统入门指南

En^_^Joy2026-06-14 16:47

文章目录

一、Django模块

Django 模板系统用于将业务逻辑（Python）与展示逻辑（HTML/CSS/JS）分离，通过模板语言动态生成页面内容。其核心特性包括变量替换、标签控制和模板继承

1.1 模板语法基础

基本配置

模板文件一般放在项目的template目录下，在该目录中创建一个index.html文件

html 复制代码 
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Django模板</title>
</head>
<body>
    <a>Django模板</a>
</body>
</html>

在settings.py 的 TEMPLATES 中添加下面字段

python 复制代码 
TEMPLATES = [
	{
		# ...
		'DIRS': [os.path.join(BASE_DIR, 'template')],
	}
]

在视图views.py文件中，可以直接返回template 里面的文件

python 复制代码 
from django.shortcuts import render

def index(request):
    # 参数1: 当前的请求  参数2: 模板文件
    return render(request, 'index.html')

1.2 变量与标签使用

如果要将数据传入到index.html中，在index.html中可以使用{``{ data }}接收数据传入变量（运算符两侧必须要有空格），如果涉及循环或条件判断，则可以使用{% tag %}标签

html 复制代码 
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Django模板</title>
</head>
<body>
		<!-- 变量 -->
    <a>{{ name }}</a>
		<!-- 索引 -->
    <a>{{ books.1 }}</a>
    
    <ul>
		<!-- 标签：遍历读取 -->
        {% for book in books %}
            <li>{{ book }}</li>
        {% endfor %}
    </ul>
    
    
    <!-- 标签：条件判断 -->
	{% if age >10 %}
	    大于10岁
	{% else %}
	    不大于10岁
	{% endif %}
</body>
</html>

接着修改views.py，通过context 将数据传入html中（这里的name是下面传入字典的键，得到的就是下面传入的字典的值Python）

python 复制代码 
from django.shortcuts import render
from django.http import HttpResponse

def index(request):
    # 参数1: 当前的请求   参数2: 模板文件   参数3：context传递参
    return render(request, 'index.html', context={'name': 'Python', 'book': ['aa', 'bb'], 'age': 10})

1.3 过滤器（默认值、日期格式等）

语法：{``{ 变量|过滤器:参数 }}

过滤器 含义
default 默认值 （如果变量不存在时则返回默认值 `date
length 长度 （返回字符丰包含字符的个数，或列表、元组、字典的元素个数）
safe 转义 （返回内容为html当存文本处理，使用转义可转为存文本）
date 日期 （用于对日期类型的值进行字符串格式化 `value
日期格式化字符 含义 解释
Y 年 格式4位（y两位）
m 月 01,02,12
d 日 01,02
j 日 1,2
H 时 24小时制（h12小时制）
i 分 0-59
s 秒 0-59

举例

python 复制代码 
from django.shortcuts import render
from django.views import View
import datetime

class HomeView(View):
    def get(self,request):
        username = request.GET.get('username')
        context = {
            'datetime': datetime.datetime.now(),
        }
        return render(request, 'index.html', context=context)
html 复制代码 
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
日期：{{ datetime|date:'Y m d' }}
</body>
</html>

二、模板继承

当某些内容在多个页面中公用时，可以使用模板继承的方法，常用于 header 和 footer 部分

父标签

我们可以建立一个基础的文件 base.html，供下方使用，这里使用block标签在父模板中预留区域，在子模板中将其替换填充差异性的内容。预留区域也可以直接填写内容（即默认内容），当子模块未填充的时候，则使用这里的默认内容

html 复制代码 
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>{% block title %}Title{% endblock title %}</title>
</head>
<body>
{% block header %}
<h1>顶部</h1>
{% endblock header %}

{% block main %}
<h1>主要部分</h1>
{% endblock main %}

{% block footer %}
<h1>底部</h1>
{% endblock footer %}
</body>
</html>

子标签

在子模块中，可以在第一行使用标签extends将父标签导入进来，然后使用 block标签 填写该区域对应的内容。子模版不用填充父模版中的所有预留区域，如果子模版没有填充，则使用父模版定义的默认值

html 复制代码 
{% extends 'base.html' %}

{% block title %}
替换标题
{% endblock title %}

{% block main %}
<a href="">替换主体</a>
{% endblock main %}

{% block footer %}{% endblock %}

三、jinja2模板

jinja2是 Python 下的一个被广泛应用的模板引擎，是由Python实现的模板语言，他的设计思想来源于Django的模板引擎，并扩展了其语法和一系列强大的功能，尤其是Flask框架内置的模板语言。由于django默认模板引擎功能不齐全,速度慢，所以我们也可以在Django中使用jinja2，jinja2宣称比django默认模板引擎快10-20倍。Django主流的第三方APP基本上也都同时支持Diango默认模板及inja2，所以要用inia2也不会有多少障碍。
jinja2模板安装 ：pip install jinja2

jiaja2配置：在settings.py中配置

python 复制代码 
TEMPLATES = [
    {
        # 'BACKEND': 'django.template.backends.django.DjangoTemplates',  # 默认引擎
        'BACKEND': 'django.template.backends.jinja2.Jinja2',  # 修改为Jinja2模板
        'DIRS': [os.path.join(BASE_DIR, 'template')],
        'APP_DIRS': True,
        'OPTIONS': {
            'environment': 'jinja2.Environment',  # 添加这行  默认的，可加可不加
            'context_processors': [
                'django.template.context_processors.debug',
                'django.template.context_processors.request',
                'django.contrib.auth.context_processors.auth',
                'django.contrib.messages.context_processors.messages',
            ],
        },
    },# 如果报错，原始的代码复制到下面
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',  # 默认引擎
        'DIRS': [os.path.join(BASE_DIR, 'template')],
        'APP_DIRS': True,
        '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',
            ],
        },
    },
]

如果还是按之前的方式来使用，这里可能会出现错误

html 复制代码 
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
日期：{{ datetime|date:'Y m d' }}
</body>
</html>

这是因为jiaja2的语法和上面模板的语法有些区别，区别在于过滤器不同，上面的模板是forloop，jiaja2是loop

jiaja2过滤器

优化后的内容如下

html 复制代码 
<body>
日期：{{ date(datetime) }}
</body>
python 复制代码 
from django.views import View
import datetime

class HomeView(View):
    def get(self,request):
        context = {
            'datetime': datetime.datetime.now(),
        }
        return render(request, 'index.html', context=context)

接着在子应用中创建jinja2_env.py文件，内容如下（否则会显示date未定义）

python 复制代码 
from django.template.defaultfilters import date
from jinja2 import Environment

def environment(**option):
    # 1.创建Environment实例
    env = Environment(**option)
    # 2.指定jinja2的函数指向django的指定过滤器
    env.globals.update({
        'date': date
    })
    # 3.返回Environment实例
    return env

然后修改配置 settings.py，改为调用自己定义的，改完之后就可以正常访问

python 复制代码 
TEMPLATES = [
    {
        # 'BACKEND': 'django.template.backends.django.DjangoTemplates',  # 默认引擎
        'BACKEND': 'django.template.backends.jinja2.Jinja2',  # 修改为Jinja2模板
        'DIRS': [os.path.join(BASE_DIR, 'template')],
        'APP_DIRS': True,
        'OPTIONS': {
            # 'environment': 'jinja2.Environment',  # 添加这行  默认的，可加可不加
            'environment': 'book.jinja2_env.environment',  # 指定jinja2的环境
            'context_processors': [
                'django.template.context_processors.debug',
                'django.template.context_processors.request',
                'django.contrib.auth.context_processors.auth',
                'django.contrib.messages.context_processors.messages',
            ],
        },
    },# 如果报错，原始的代码复制到下面
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',  # 默认引擎
        'DIRS': [os.path.join(BASE_DIR, 'template')],
        'APP_DIRS': True,
        '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',
            ],
        },
    },
]

要显示特定的格式，在后面和之前一样添加参数

html 复制代码 
<body>

日期：{{ date(datetime,'Y m d') }}
</body>

自定义过滤器

python 复制代码 
from jinja2 import Environment

def environment(**option):
    # 1.创建Environment实例
    env = Environment(**option)
    # 2.将自定义过滤器添加到环境中
    env.filters['do_listreverse'] = do_listreverse
    # 3.返回Environment实例
    return env

# 自定义过滤器
def do_listreverse(li):
    if li == 'B':
        return "abcd"
相关推荐
wefg132 分钟前
【MySQL】索引（索引底层原理/创建/查看/删除主键、普通、联合、前缀、全文索引）
数据库·mysql
风向决定发型丶5 小时前
redis集群搭建
数据库·redis·缓存
2501_947575806 小时前
计算机毕业设计之jsp开山车行二手车交易系统
java·开发语言·hadoop·python·信息可视化·django·课程设计
wei_shuo7 小时前
KES 扩展与插件开发实战：自定义函数、触发器与第三方插件集成
数据库·kes
风中芦苇啊8 小时前
从直接生成到受控配置：新一代图表Agent的SQL安全生成范式
数据库·sql·安全
吴声子夜歌8 小时前
SQL进阶——窗口函数
数据库·sql
周杰伦的稻香8 小时前
MySQL8.0+中引入的SET_USER_ID权限迭代SUPER权限指定 DEFINER
数据库·mysql
动恰客流统计8 小时前
客流统计如何结合AI分析？从传统计数到智能决策的技术升级路径
数据库·人工智能·边缘计算
宠友信息9 小时前
多端数据互通场景下Spring Boot仿小红书源码结构设计
数据库·spring boot·redis·缓存·架构
风曦Kisaki9 小时前
#Linux数据库管理Day06：主从同步与MaxScale读写分离
linux·运维·数据库
热门推荐
01GitHub 镜像站点022026 年 AI 编程工具终极横评：Cursor vs Claude Code vs Copilot vs Windsurf03AI科技热点日报 | 2026年07月01日04【AI】2026 年具身智能模型和世界模型总结052026 AI 编程工具终极实战指南：Cursor vs Claude Code vs Copilot，开发者该怎么选？062026年6月AI大模型全景报告：GPT-5.6、Claude Opus 4.8、Gemini 3.5，中美AI三足鼎立谁主沉浮？072026 年 AI 大模型 & AI 编程工具实战全总结08Claude Code、Codex、Cursor三分天下：2026年AI编程Agent生态全景剖析09Agnes AI 免费 API 接入指南：文本、生图、生视频，一套接口全免费102026年6月AI行业全景：从百模大战到Agent元年，这30天发生了什么？