6.1 模板系统基础

Django 6模板系统教程：基础、配置、渲染与变量语法详解

Django 6中文教程

本教程详细讲解Django 6模板系统的基础知识，包括模板文件存放路径配置方法、如何使用render函数渲染模板，以及模板变量语法与使用规则，适合新手快速入门和掌握核心概念。

Django 6模板系统详解

模板系统是Django框架中用于生成动态HTML页面的核心组件，它将业务逻辑与用户界面分离，使开发更高效、代码更易维护。本教程将从基础概念开始，逐步介绍模板系统的各个方面，特别针对Django 6版本，确保内容最新且易于理解。

1. 模板系统基础

什么是模板？

模板是包含静态HTML代码和特殊标记（如变量和标签）的文件，用于动态生成网页内容。在Django中，模板允许你将数据（来自视图）嵌入到HTML中，从而实现灵活的页面显示。

为什么使用模板？

代码分离：视图处理数据和逻辑，模板负责展示，提高可维护性。
重用性：可以创建基础模板和组件，减少重复代码。
灵活性：轻松修改界面而不影响后端代码，支持多语言和主题切换。

在Django 6中，模板系统基于Django模板语言（DTL），与其他版本兼容，但推荐使用最新功能优化性能。

2. 模板文件存放路径配置

在Django项目中，模板文件通常存放在特定目录中，需要在项目设置中进行配置。以下是详细步骤：

步骤1：创建模板目录

在项目根目录下（与manage.py同级），创建一个名为templates的文件夹。这是约定俗成的目录名，但你可以自定义。

步骤2：配置settings.py

打开项目的settings.py文件，找到TEMPLATES设置。这是一个列表，包含一个字典配置项。关键配置如下：

# settings.py
from pathlib import Path

BASE_DIR = Path(__file__).resolve().parent.parent  # 项目根目录

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',  # 使用Django模板后端
        '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',
            ],
        },
    },
]

DIRS：列表类型，指定模板文件的搜索路径。使用BASE_DIR / 'templates'确保路径正确。如果项目有多个模板目录，可以添加更多路径。
APP_DIRS：设置为True时，Django会自动在每个已安装应用（如myapp）的templates子目录中查找模板。这有助于模块化开发。
context_processors：预定义的处理器，为所有模板自动提供如request、user等变量。

步骤3：验证配置

运行Django开发服务器（python manage.py runserver），如果配置正确，视图可以正常渲染模板。如果遇到模板找不到错误，检查路径拼写和目录结构。

提示：在Django 6中，推荐使用pathlib处理路径，以提高跨平台兼容性。

3. 模板渲染方法（render函数）

在Django视图中，使用render函数将模板和数据结合，生成HTTP响应。这是最常用的渲染方法。

render函数介绍

render函数位于django.shortcuts模块中，简化了模板渲染过程。其基本语法如下：

from django.shortcuts import render

def view_name(request):
    context = {'key1': 'value1', 'key2': 'value2'}  # 上下文数据，字典格式
    return render(request, 'template_name.html', context)

参数说明：
- request：必须的HttpRequest对象，包含用户请求信息。
- template_name：字符串，指定模板文件的路径。路径相对于DIRS中配置的模板目录。例如，如果模板在templates/myapp中，则使用'myapp/template.html'。
- context（可选）：字典类型，包含要传递给模板的变量。如果省略，模板将只接收通过上下文处理器提供的变量。
返回值：返回一个HttpResponse对象，可以直接发送给客户端。

实际示例

假设有一个简单的博客应用，模板文件为templates/blog/index.html：

<!-- blog/index.html -->
<!DOCTYPE html>
<html>
<head>
    <title>{{ page_title }}</title>
</head>
<body>
    <h1>欢迎来到我的博客！</h1>
    <p>最新文章: {{ latest_post }}</p>
</body>
</html>

对应的视图函数在views.py中：

# blog/views.py
from django.shortcuts import render

def index(request):
    # 模拟从数据库获取数据
    context = {
        'page_title': '博客首页',
        'latest_post': 'Django 6新特性介绍'
    }
    return render(request, 'blog/index.html', context)

当用户访问该视图时，render函数会加载blog/index.html模板，将context中的变量（page_title和latest_post）替换到模板中，生成最终的HTML响应。

进阶技巧：在Django 6中，render函数还支持可选参数如content_type（设置响应MIME类型）和status（HTTP状态码），以增强灵活性。

4. 模板变量语法与使用规则

模板变量是Django模板语言的核心，用于在模板中插入动态数据。语法简单但功能强大。

基本变量语法

变量用双大括号{{ }}包裹，例如{{ variable_name }}。当模板渲染时，变量会被替换为其值。

示例：如果上下文中有{'name': 'Alice'}，那么{{ name }}在模板中会输出“Alice”。

变量类型和访问

Django模板支持多种Python数据类型，访问方式灵活：

简单类型：字符串、数字、布尔值等直接使用。例如，{{ age }}可能输出25。
列表和元组：使用索引访问，索引从0开始。例如，如果items = ['a', 'b', 'c']，那么{{ items.0 }}输出“a”。
字典：使用点号.访问键。例如，如果user = {'name': 'Bob', 'role': 'admin'}，那么{{ user.name }}输出“Bob”。
对象属性：如果上下文传递了一个对象，可以直接访问其属性。例如，假设有一个Post对象，{{ post.title }}会调用对象的title属性。

注意：如果变量不存在或为None，Django模板会静默地输出空字符串，避免错误。

过滤器（Filters）

过滤器用于在模板中对变量进行修改或格式化，语法为{{ variable|filter_name:arg }}。常用过滤器包括：

{{ name|upper }}：将字符串转换为大写。
{{ text|truncatewords:10 }}：截断文本到前10个单词。
{{ date|date:'Y-m-d' }}：格式化日期。
{{ value|default:'N/A' }}：如果变量为空，使用默认值。

Django 6内置了丰富的过滤器，你还可以自定义过滤器以满足特定需求。

标签（Tags）

标签用{% %}包裹，用于执行更复杂的逻辑，如循环和条件语句。虽然本教程聚焦变量，但了解基本标签有助于全面使用模板：

循环：{% for item in list %} ... {% endfor %}，用于遍历列表或查询集。
条件：{% if condition %} ... {% endif %}，用于条件渲染。

使用规则总结

命名规范：变量名应遵循Python标识符规则，通常使用小写字母和下划线（如user_name）。
避免复杂逻辑：模板主要用于展示，复杂业务逻辑应放在视图中。
安全性：Django模板自动转义HTML特殊字符，防止XSS攻击，但可以使用safe过滤器关闭转义（需谨慎）。
调试：如果变量不显示，检查视图中的上下文数据是否正确传递，或使用{{ variable|default:'未定义' }}进行调试。

完整示例

结合变量、过滤器和标签的模板示例：

<!-- templates/example.html -->
<h1>用户信息</h1>
<p>姓名: {{ user.name|title }}</p>  <!-- 使用title过滤器首字母大写 -->
<p>年龄: {{ user.age|default:'未知' }}</p>
<ul>
{% for hobby in hobbies %}
    <li>{{ hobby|lower }}</li>  <!-- 将爱好转换为小写 -->
{% empty %}
    <li>暂无爱好</li>
{% endfor %}
</ul>

对应视图：

def example_view(request):
    context = {
        'user': {'name': 'john doe', 'age': 30},
        'hobbies': ['Reading', 'Coding', 'Hiking']
    }
    return render(request, 'example.html', context)

输出结果中，姓名会显示为“John Doe”，爱好列表项为小写。

练习建议

为了加深理解，建议新手尝试以下练习：

创建一个Django 6项目，配置模板路径并添加一个简单模板。
编写视图使用render函数传递不同类型的数据（如字符串、列表、字典）。
在模板中使用变量、过滤器和基本标签，观察渲染效果。
查阅Django 6官方文档，探索更多高级模板特性。

通过本教程，你应该能掌握Django 6模板系统的基础知识，并能自信地应用到实际项目中。模板系统是Django强大功能的一部分，熟练使用它将显著提升开发效率。

上一章 5.5 请求参数处理

下一章 6.2 模板标签与过滤器