Jinja2

发表于 更新于 分类于 本文字数： 2.5k 阅读时长 ≈ 2 分钟

写 Python Web 项目时，如果页面内容里既有固定结构，又有动态数据，那通常就会接触到模板引擎。比如用户列表、文章详情页、后台管理页，这些内容的 HTML 结构大体固定，但里面的数据是运行时才知道的。

Jinja2 就是这类场景里最常见的模板引擎之一。它在 Flask 生态里尤其常见，但并不只服务于 Flask。简单说，它的作用就是把模板和数据组合起来，最后渲染成真正的文本输出，最常见的是 HTML。

Jinja2 是什么

Jinja2 是 Python 生态里一个很常用的模板引擎。官方文档对它的描述是：一个快速、可扩展、表达能力很强的模板引擎。

如果把这个定义说得更直白一点，它就是一套“用模板生成文本”的工具。这个文本可以是 HTML，也可以是 XML、CSV、邮件内容，甚至任意文本格式。

Jinja2 的核心思路并不复杂：

  • 模板里写页面结构
  • 运行时传入数据
  • 模板引擎把占位内容替换掉
  • 最后得到完整输出

可以简单理解成下面这个过程：

flowchart LR
    A[Template] --> C[Jinja2 Render]
    B[Context Data] --> C
    C --> D[HTML / Text Output]

为什么很多项目会用 Jinja2

如果后端直接拼字符串输出 HTML，当然也能完成需求，但页面一复杂就会很难维护。

模板引擎的价值就在这里：

  • 页面结构和数据分开
  • 重复布局可以复用
  • 条件判断和循环渲染更方便
  • 前后端职责更清楚

Jinja2 在 Python 里很常见，一个重要原因就是它语法不难，和 Python 的思路也比较接近，上手成本比较低。

Jinja2 的基本语法

Jinja2 最常见的三种分隔符如下：

  • {{ ... }} 用来输出表达式结果
  • {% ... %} 用来写控制语句
  • `` 用来写注释

比如下面这个模板：

1
2
3
4
5
<ul>
{% for user in users %}
  <li>{{ user.name }}</li>
{% endfor %}
</ul>

渲染时如果传入一个 users 列表，最终就会输出真正的 HTML 列表内容。

这种语法看起来很直接，所以很多人第一次接触时基本就能看懂。

Jinja2 常见能力

条件和循环

Jinja2 支持 if、for 这类常见控制结构，所以渲染动态页面时会比较自然。

1
2
3
4
5
{% if user %}
  <p>Hello, {{ user.username }}</p>
{% else %}
  <p>Hello, guest</p>
{% endif %}

模板继承

这是 Jinja2 很常用的一部分。可以先定义一个基础模板，把页头、页脚、导航栏这些公共部分放进去，再让子模板只关心自己那一块内容。

1
2
3
4
5
{% extends "base.html" %}

{% block content %}
  <h1>Article Detail</h1>
{% endblock %}

这种写法很适合做后台系统或者内容站点，因为公共布局通常很多。

过滤器

Jinja2 支持过滤器，可以在模板里对数据做简单处理，比如大小写转换、长度统计、转义等。

1
{{ username|upper }}

过滤器适合做轻量处理，但如果逻辑已经变复杂，通常还是应该放回 Python 代码里。

宏和复用

Jinja2 还支持宏，可以把重复的模板片段封装起来，像函数一样复用。

这在表单、分页、通用卡片、按钮片段这类场景里会比较方便。

Jinja2 在项目里一般怎么用

在 Flask 里，Jinja2 基本就是默认模板引擎。后端把数据传给模板，模板再负责渲染页面。

一个很常见的例子是：

1
2
3
4
5
from flask import render_template

@app.route("/users")
def users():
    return render_template("users.html", users=user_list)

这里 render_template 最终就会调用 Jinja2，把 users.html 和 user_list 结合起来输出 HTML。

除了 Flask，很多静态站点工具、自动化脚本、代码生成工具里也会用到 Jinja2，因为它本质上不依赖 Web 框架。

使用 Jinja2 时要注意什么

模板里不要堆太多业务逻辑

Jinja2 支持条件、循环、过滤器、宏，所以很容易一步一步把逻辑写进模板里。短期看很方便，但一旦模板变复杂，后面就会很难维护。

一般来说，模板更适合负责展示，复杂逻辑尽量留在 Python 层。

注意自动转义

Jinja2 支持 autoescaping，这一点对 HTML 页面很重要。它可以在很多场景下帮助减少 XSS 风险。

如果手动把不可信内容标记成安全输出，比如乱用 |safe，那就会把模板的安全边界直接削弱掉。

不要把不可信模板直接渲染

Jinja2 很强大，这也意味着如果把不可信模板内容直接交给它执行，会有明显风险。在一些安全场景里，这类问题通常会和服务端模板注入（SSTI）联系在一起。

小结

Jinja2 可以理解成 Python 生态里很经典的一套模板引擎。它的优点不只是语法简单，更重要的是模板继承、过滤器、宏这些能力让页面复用和动态渲染都比较自然。

如果项目本身有服务端渲染页面、邮件模板、文本生成这类需求，Jinja2 仍然是一套很好用的工具。

参考资料