Django模板语法深度解析从基础标签到自定义扩展的完整指南

Django模板语法基础：变量与标签

Django模板系统的核心是变量替换和简单的逻辑控制。所有模板标签都被包裹在花括号和百分号中，例如{% tag %}。最基本的语法是变量输出，使用双花括号{{ variable }}。当模板引擎遇到一个变量时，它会计算该变量并将其替换为结果。变量名由字母、数字和下划线组成，点号（.）有特殊含义，用于访问变量的属性或字典键。如果变量不存在，模板系统将插入一个空字符串。

常用内置标签详解

Django提供了一系列内置标签来处理逻辑控制流。

{% if %} 条件判断标签

{% if %}标签用于在模板中执行条件判断。它支持使用and、or和not来组合多个条件，也支持使用运算符如==、!=、<、>等。标签必须由{% endif %}闭合。Django模板语言不允许在条件判断中使用括号来明确优先级，因此复杂的逻辑可能需要使用嵌套的if标签。

{% for %} 循环迭代标签

{% for %}标签用于遍历序列（如列表、查询集）。在循环内部，可以使用一些特殊的模板变量，例如`forloop.counter`（当前循环的索引，从1开始）和`forloop.counter0`（从0开始）。如果被遍历的序列为空，可以使用可选的{% empty %}子句来显示替代内容。循环必须以{% endfor %}结束。

{% block %} 与 {% extends %} 模板继承标签

这是Django模板系统最强大的功能之一。{% extends “base.html” %}标签用于声明当前模板继承自一个父模板（如base.html）。{% block %}标签则在父模板中定义可以被子模板覆盖的区块。子模板通过重新定义同名的block来填充具体内容，从而实现代码复用和页面结构的统一管理。

{% include %} 模板包含标签

{% include %}标签用于将另一个模板的内容包含进来。这非常适合用于复用常见的页面组件，如页眉、页脚、导航栏等。它允许你将模板分解成更小的、可管理的部分。

{% url %} 反向解析URL

{% url %}标签用于根据Django的URL配置（urls.py）中定义的URL名称，动态地生成URL。这避免了在模板中硬编码URL路径，使得项目在修改URL模式时，无需更改所有模板中的链接。

{% csrf_token %} 跨站请求伪造保护

在任何使用POST方法的表单中，必须包含{% csrf_token %}标签。它会生成一个隐藏的输入字段，其中包含一个安全令牌，用于防止跨站请求伪造攻击。Django的中间件会验证这个令牌，如果缺失或不匹配，请求将被拒绝。

模板过滤器：修饰变量输出

过滤器用于在变量被显示之前修改其值。它们在变量管道（|）后指定，并且可以串联使用。格式为{{ variable|filter }}。例如，{{ name|lower }}会将变量name的值转换为小写。Django内置了众多实用的过滤器，如`date`（格式化日期）、`length`（返回长度）、`slice`（切片）、`truncatewords`（截取单词）等。过滤器也可以接收参数，例如{{ value|date:Y-m-d }}。

自定义模板标签和过滤器

当内置功能无法满足需求时，Django允许开发者创建自定义的模板标签和过滤器。

创建自定义过滤器

自定义过滤器本质上就是一个Python函数。该函数接收一个或两个参数：第一个是待处理的变量值，第二个是可选参数。函数需要被注册到模板库中。首先，在某个应用下创建一个名为`templatetags`的Python包（包含`__init__.py`文件），然后在该包内创建一个模块文件（如`custom_filters.py`）。使用`register.filter`装饰器注册函数，之后就可以在模板中通过`{% load custom_filters %}`加载并使用。

创建自定义标签

自定义标签比过滤器更复杂，它可以执行任意操作。简单的标签（返回字符串）可以通过`@register.simple_tag`装饰器创建。对于那些需要复杂逻辑和处理上下文的标签，需要继承`django.template.Node`类并重写`render`方法。之后，需要编译函数将模板标签解析为Node子类。自定义标签同样需要在`templatetags`模块中注册和加载。

高级主题：内部机制与最佳实践

理解Django模板的编译和渲染过程有助于更好地使用和扩展它。模板引擎将模板源代码编译成一系列Node对象，每个Node知道如何将自己渲染为字符串。在渲染时，引擎会传入一个Context对象（包含变量及其值），Node们根据Context生成最终的HTML。在性能方面，应避免在模板中进行复杂的计算或频繁的数据库查询，这些操作最好在视图中完成。合理使用`{% with %}`标签可以缓存复杂查询的结果，避免重复计算。模板继承是组织代码结构的关键，建议建立一个清晰的基模板，定义好主要的block，并保持子模板的简洁和专注。