详解如何在Python中使用Jinja2进行模板渲染_Python

前言

jinja2 是一个现代的、设计精美的 python 模板引擎。它使用类似于 django 的模板语言来渲染文本文件。jinja2 提供了动态网页生成的强大功能，是很多 web 框架（如 flask）的默认模板引擎。下面我将通过几个例子展示如何在 python 中使用 jinja2 进行模板渲染。

安装 jinja2

首先，确保你已经安装了 jinja2，可以使用 pip 进行安装：

pip install jinja2

基本用法

以下是 jinja2 的基本用法，包括模板字符串和模板文件的渲染。

1. 渲染模板字符串

from jinja2 import template

# 定义模板字符串
template_string = "hello, {{ name }}!"

# 创建模板对象
template = template(template_string)

# 渲染模板
output = template.render(name="world")
print(output)  # 输出: hello, world!

2. 渲染模板文件

首先，创建一个模板文件 template.html：

<!doctype html>
<html>
<head>
    <title>{{ title }}</title>
</head>
<body>
    <h1>hello, {{ name }}!</h1>
</body>
</html>

然后，在 python 代码中渲染这个模板文件：

from jinja2 import environment, filesystemloader

# 创建一个加载器，指向模板文件所在目录
file_loader = filesystemloader('path/to/templates')

# 创建一个环境对象
env = environment(loader=file_loader)

# 加载模板文件
template = env.get_template('template.html')

# 渲染模板
output = template.render(title="jinja2 example", name="world")
print(output)

高级用法

jinja2 支持很多高级功能，如循环、条件判断和过滤器等。

1. 循环

在模板文件中，你可以使用 {% for %} 标签进行循环：

<ul>
{% for item in items %}
    <li>{{ item }}</li>
{% endfor %}
</ul>

然后在 python 代码中：

template_string = """
<ul>
{% for item in items %}
    <li>{{ item }}</li>
{% endfor %}
</ul>
"""
template = template(template_string)
output = template.render(items=["apple", "banana", "cherry"])
print(output)

2. 条件判断

可以使用 {% if %} 标签进行条件判断：

{% if user %}
    <p>welcome, {{ user }}!</p>
{% else %}
    <p>please log in.</p>
{% endif %}

然后在 python 代码中：

template_string = """
{% if user %}
    <p>welcome, {{ user }}!</p>
{% else %}
    <p>please log in.</p>
{% endif %}
"""
template = template(template_string)
output = template.render(user="john doe")
print(output)

3. 过滤器

jinja2 提供了很多内置过滤器，例如 upper、lower 等：

<p>{{ message|upper }}</p>

在 python 代码中：

template_string = "<p>{{ message|upper }}</p>"
template = template(template_string)
output = template.render(message="hello, world!")
print(output)  # 输出: <p>hello, world!</p>

自定义过滤器

你还可以创建自定义过滤器：

def reverse_filter(s):
    return s[::-1]

env = environment()
env.filters['reverse'] = reverse_filter

template_string = "reversed message: {{ message|reverse }}"
template = env.from_string(template_string)
output = template.render(message="hello, world!")
print(output)  # 输出: reversed message: !dlrow ,olleh