Django 模板变量与标签实战指南：90% 的 Django 新手都忽略了这几个细节

很多刚学习 Django 的开发者都会产生一个错觉：

> 模板层只是 HTML + {{变量}}

实际上，在真实项目中，模板层承担着大量工作：

* 页面逻辑控制
* 数据循环渲染
* 表单状态保持
* 组件复用

如果没有理解 Django 模板机制，很容易写出 **难维护甚至错误的页面逻辑**。

这篇文章我们系统梳理 Django 模板层最核心的内容。

---

# 文章目录

1. Django 模板层在 MTV 架构中的作用
1. View 如何向 Template 传递变量
1. Django 模板支持哪些数据结构
1. 模板变量调用规则（重点）
1. Django 模板标签语法
1. if 标签详解
1. for 标签与 empty 用法
1. forloop 内置变量详解
1. 实战案例：Django 计算器
1. Django 模板开发常见坑
1. Django 模板的重要补充知识

---

# 一、Django 模板层在 MTV 架构中的作用

Django 使用 **MTV 架构**：

* Model：数据层
* Template：视图展示层
* View：业务逻辑层

请求流程如下：

```mermaid
flowchart LR

A[浏览器请求] --> B[URL路由]
B --> C[View视图函数]
C --> D[业务逻辑处理]
D --> E[render传递数据]
E --> F[Template模板]
F --> G[HTML页面]
G --> H[浏览器渲染]
```

简单理解：

**View 负责数据处理
Template 负责页面渲染**

两者之间通过 **变量字典进行通信**。

---

# 二、View 如何向 Template 传递变量

Django 最常见写法：

```python
def index(request):

    context = {
        "name": "Tom",
        "age": 18
    }

    return render(request, "index.html", context)
```

render 函数结构：

```
render(request, template_name, context)
```

第三个参数 **context** 是一个字典。

模板中可以通过：

```
{{ name }}
```

访问数据。

---

# 三、Django 模板支持哪些数据结构

Django 模板可以接收 **绝大多数 Python 对象**：

1 字符串
2 整数
3 list
4 tuple
5 字典
6 函数
7 类实例对象
8 QuerySet

示例：

```python
def test(request):

    data = {
        "name": "Tom",
        "age": 20,
        "hobby": ["coding", "game"],
        "info": {"city": "Beijing"},
        "func": test_func
    }

    return render(request, "test.html", data)
```

注意一点：

如果传递函数

正确：

```
"func": test_func
```

错误：

```
"func": test_func()
```

后者传递的是 **函数执行结果**。

---

# 四、模板变量调用规则（重点）

模板中变量语法：

```
{{ variable }}
```

示例：

```html
<p>{{ name }}</p>
<p>{{ age }}</p>
```

---

## Django 模板点查找规则

Django 使用 **统一的点查找机制**：

```
{{ object.attribute }}
```

查找顺序：

1 字典 key
2 对象属性
3 方法调用
4 列表索引

例如：

```python
data = {
    "user": user,
    "list": ["A", "B"]
}
```

模板：

```html
{{ user.name }}
{{ list.0 }}
```

---

## 模板方法调用规则

模板可以调用方法：

```
{{ user.get_full_name }}
```

但 Django 模板 **只允许调用无参数方法**。

这是出于 **安全性设计**。

---

# 五、Django 模板标签语法

模板标签用于 **逻辑控制**。

语法：

```
{% 标签 %}
```

结束标签：

```
{% end标签 %}
```

示例：

```
{% if %}
{% endif %}
```

---

# 六、if 标签详解

基本语法：

```html
{% if age > 18 %}

成年人

{% else %}

未成年

{% endif %}
```

支持的操作符：

* ==
* !=
* >
* <
* > =
* <=
* and
* or
* not

注意：

Django 模板 **不支持复杂括号表达式**。

---

# 七、for 标签与 empty 用法

循环结构：

```html
{% for item in list %}

{{ item }}

{% endfor %}
```

---

## empty 标签

当列表为空时：

```html
{% for item in list %}

{{ item }}

{% empty %}

暂无数据

{% endfor %}
```

这个设计比 Python 更方便。

---

# 八、forloop 内置变量详解

for 循环中 Django 提供一个特殊变量：

```
forloop
```

常用属性：

| 变量                 | 含义     |
| ------------------ | ------ |
| forloop.counter    | 从1开始   |
| forloop.counter0   | 从0开始   |
| forloop.revcounter | 倒序索引   |
| forloop.first      | 是否第一次  |
| forloop.last       | 是否最后一次 |

示例：

```html
{% for name in names %}

{{ forloop.counter }} {{ name }}

{% endfor %}
```

---

# 九、实战案例：Django 计算器

页面结构：

* 输入数字A
* 运算符选择
* 输入数字B
* 点击计算

流程如下：

```mermaid
flowchart TD

A[输入数字A] --> D[提交表单]
B[选择运算符] --> D
C[输入数字B] --> D

D --> E[POST请求]

E --> F[Django视图]

F --> G[计算结果]

G --> H[返回模板]
```

---

## View 代码

```python
def mycal(request):

    result = None
    n1 = None
    n2 = None
    op = None

    if request.method == "POST":

        n1 = request.POST.get("n1")
        n2 = request.POST.get("n2")
        op = request.POST.get("op")

        try:
            n1 = int(n1)
            n2 = int(n2)

            if op == "+":
                result = n1 + n2
            elif op == "-":
                result = n1 - n2

        except:
            result = "输入错误"

    return render(request, "cal.html", locals())
```

locals() 会把函数中的变量打包成字典。

---

# 十、表单状态保持

当页面刷新时，用户的选择容易丢失。

可以这样写：

```html
<option value="+" {% if op == "+" %} selected {% endif %}>
+
</option>
```

这样提交后仍然保持用户选择。

---

# 十一、Django 模板重要补充知识

这里补充三个很多教程不会讲的关键点。

---

## 1 模板过滤器

过滤器用于处理变量。

语法：

```
{{ value | filter }}
```

示例：

```html
{{ name | upper }}
```

常用过滤器：

| 过滤器     | 作用  |
| ------- | --- |
| upper   | 大写  |
| lower   | 小写  |
| length  | 长度  |
| default | 默认值 |

示例：

```
{{ username|default:"匿名用户" }}
```

---

## 2 模板自动转义

Django 默认开启 **XSS 防护**。

示例：

```
<script>alert(1)</script>
```

模板输出：

```
&lt;script&gt;
```

如果需要关闭：

```
{{ content|safe }}
```

---

## 3 模板继承

大型项目都会使用模板继承：

```html
{% extends "base.html" %}
```

然后定义块：

```html
{% block content %}

页面内容

{% endblock %}
```

这样可以实现 **统一页面布局管理**。

---

# 结语

Django 模板系统虽然语法简单，但设计非常成熟。

核心能力包括：

1 变量传递
2 模板逻辑控制
3 数据循环
4 页面状态保持
5 模板继承与组件化

理解这些机制后，你会发现：

> Django 模板不仅是 HTML 模板，而是一个完整的 **视图渲染系统**。