前言

jinja2 是 Flask 作者开发的一个模板系统，起初是仿 Django 模板的一个模板引擎，为 Flask 提供模板支持，由于其灵活，快速和安全等优点被广泛使用。当我们开发 Web 应用程序时，通常需要将数据动态地渲染到 HTML 模板中，而 Python jinja2 模版技术正是为此而生的。

要了解jinja2，那么需要先理解模板的概念。模板在 Python 的web开发中广泛使用，它能够有效的将业务逻辑和页面逻辑分开，使代码可读性增强、并且更加容易理解和维护。

模板简单来说就是一个其中包含 占位变量 表示动态部分的文件，模板文件在经过动态赋值后，返回给用户。

模板渲染流程

Jinja2简介

Jinja2 是一个流行的 Python 模板引擎，它可以帮助我们将数据渲染到各种格式的文档中，如 HTML、XML、Markdown 等。Jinja2 具有以下几个特性：

简单而灵活的语法
支持模板继承和包含
支持过滤器和控制结构
可以自定义全局变量

安装

使用 pip 命令可以很容易地安装 Jinja2：

pip install Jinja2

基本语法

Jinja2 的基本语法与 Python 很相似，包括变量、表达式、控制结构等。下面是一些示例：

<!-- 变量 -->
<p>Hello, {{ name }}!</p>
<!-- 表达式 -->
{% if count > 10 %}
  <p>There are too many items.</p>
{% else %}
  <p>There are {{ count }} items.</p>
{% endif %}
<!-- 循环 -->
<ul>
{% for item in items %}
  <li>{{ item }}</li>
{% endfor %}
</ul>

在这个示例中，我们使用了变量、表达式和循环结构来渲染模板。变量使用 {{ ... }} 语法，表达式使用 {% ... %} 语法，循环结构使用 {% for ... in ... %} ... {% endfor %} 语法。

模板继承和包含

模板继承

Jinja2中最强大的部分就是模板继承。模板继承允许我们创建一个基本(骨架/Base)文件，其他模版文件从该骨架文件继承，然后针对需要的地方进行修改。

Jinja2的Base文件中，利用 block 关键字表示其包含的内容可以进行修改。可以帮助我们避免重复的代码和布局。

下面是一个示例：

<!-- base.html -->
<html>
<head>
  <title>{% block title %}{% endblock %}</title>
</head>
<body>
  {% block content %}
  {% endblock %}
</body>
</html>
<!-- page.html -->
{% extends "base.html" %}
{% block title %}My Page{% endblock %}
{% block content %}
  <h1>Welcome to my page!</h1>
{% endblock %}

在这个示例中，我们定义了一个基础模板 base.html，它包含了页面的基本结构和布局。我们还定义了一个子模板 page.html，它继承了 base.html，并覆盖了其中的标题和内容块。

模板包含

除了模板继承之外，Jinja2 还支持模板包含，可以将重复的代码抽象为一个单独的模板，然后在其他模板中引用它。

这可以帮助我们避免重复的代码和布局。下面是一个示例：

<!-- header.html -->
<header>
  <h1>My Website</h1>
  <nav>
    <ul>
      <li><a href="/">Home</a></li>
      <li><a href="/about">About</a></li>
      <li><a href="/contact">Contact</a></li>
    </ul>
  </nav>
</header>
<!-- page.html -->
{% include "header.html" %}
<main>
  <h1>Welcome to my page!</h1>
  <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit.</p>
</main>
{% include "footer.html" %}

在这个示例中，我们定义了一个头部模板 header.html，它包含了网站的标题和导航菜单。然后我们在页面模板 page.html 中引用了头部模板和尾部模板 footer.html，以构建完整的页面。

使用模板包含可以帮助我们更好地组织代码和布局，使代码更易于维护和扩展。

过滤器和控制结构

变量可以通过 过滤器 进行修改，过滤器可以理解为是jinja2里面的内置函数和字符串处理函数。

常用的过滤器有：

过滤器名称	说明
safe	渲染时值不转义
capitialize	把值的首字母转换成大写，其他子母转换为小写
lower	把值转换成小写形式
upper	把值转换成大写形式
title	把值中每个单词的首字母都转换成大写
trim	把值的首尾空格去掉
striptags	渲染之前把值中所有的HTML标签都删掉
join	拼接多个值为字符串
replace	替换字符串的值
round	默认对数字进行四舍五入，也可以用参数进行控制
int	把值转换成整型

除了上述特性，Jinja2 还有其他一些有用的功能，下面介绍其中几个：

安全过滤器

在模板中渲染用户提供的数据时，安全性是一个非常重要的问题。Jinja2 提供了一个安全过滤器，可以帮助我们过滤掉一些危险的 HTML 标签和属性，以防止 XSS 攻击等安全问题。

安全过滤器示例：

{{ user_input|safe }}

循环控制结构

除了基本的循环结构之外，Jinja2 还提供了一些高级的循环控制结构，比如 break、continue 和 loop.index0 等。这些控制结构可以帮助我们更好地控制循环过程。

在for循环中，jinja2提供了一些特殊的变量，用以来获取当前的遍历状态：

变量	描述
loop.index	当前迭代的索引（从1开始）
loop.index0	当前迭代的索引（从0开始）
loop.first	是否是第一次迭代，返回bool
loop.last	是否是最后一次迭代，返回bool
loop.length	序列中的项目数量
loop.revindex	到循环结束的次数（从1开始）
loop.revindex0	到循环结束的次数(从0开始）

循环控制结构示例：

{% for item in items %}
  {% if item == 'stop' %}
    {% break %}
  {% elif item == 'skip' %}
    {% continue %}
  {% endif %}
  <li>{{ loop.index0 }}: {{ item }}</li>
{% endfor %}

自定义全局变量

除了在模板中定义变量之外，Jinja2 还支持在 Python 代码中定义全局变量，然后在模板中使用。这可以帮助我们更好地组织代码和数据。

自定义全局变量示例：

from jinja2 import Environment
# 定义全局变量
my_var = 'Hello, world!'
# 创建模板引擎
env = Environment()
# 添加全局变量
env.globals['my_var'] = my_var
# 渲染模板
template = env.from_string('<p>{{ my_var }}</p>')
result = template.render()
print(result)

在这个示例中，我们定义了一个全局变量 my_var，然后将它添加到模板引擎的全局变量中。最后，我们使用模板引擎渲染了一个模板，并输出了结果。

使用Jinja2进行渲染

jinja2模块中有一个名为Enviroment的类，这个类的实例用于存储配置和全局对象，然后从文件系统或其他位置中加载模板。

基本使用方法

大多数应用都在初始化的时候创建一个Environment对象，并用它加载模板。Environment支持两种加载方式：

PackageLoader：包加载器
FileSystemLoader：文件系统加载器

PackageLoader

参数：

PackageLoader()的两个参数为：python包的名称，以及模板目录名称。
get_template()：获取模板目录下的某个具体文件。
render()：接受变量，对模板进行渲染

使用包加载器来加载文档的最简单的方式如下：

from jinja2 import PackageLoader,Environment
# 创建一个包加载器对象
env = Environment(loader=PackageLoader('项目xx包目录','templates'))
# 获取一个模板文件
template = env.get_template('bast.html')    
# 渲染
template.render(name='daxin',age=18)

FileSystemLoader

文件系统加载器，不需要模板文件存在某个Python包下，可以直接访问系统中的文件

总结

Jinja2 是一个强大而灵活的 Python 模板引擎，它可以帮助我们将数据渲染到各种格式的文档中。它具有简单而灵活的语法、支持模板继承和包含、支持过滤器和控制结构等特性。如果你需要在 Python 中使用模板引擎，Jinja2 是一个不错的选择。

当然，除了可以在 Python Web 开发过程中使用Jinja2模版，如果大家在做自动化脚本（自动化用例）时也可以使用它，可以根据相关自动化信息（比如：用例编号、步骤、断言等）批量生成不同自动化测试用例（脚本）。总之，Jinja2 的使用场景可以用于多种需求下

Jinja2：使用Python进行模板渲染的艺术

前言