大家好，今天为大家分享一个有趣的 Python 库 - jinja。
Github地址：https://github.com/pallets/jinja
模板引擎在现代 Web 开发中扮演着重要的角色，它们使开发人员能够将数据动态地呈现为 HTML、XML、JSON 等格式，从而实现网页的动态生成。Python 中有许多流行的模板引擎，其中之一就是 Jinja2。本文将深入介绍 Jinja2，包括其核心概念、用法以及丰富的示例代码。
什么是 Jinja2？Jinja2 是一个用于 Python 的模板引擎，它允许开发人员将动态数据插入到模板中，生成最终的输出。它的语法简洁清晰，易于学习和使用，因此受到了广泛的欢迎。
与其他模板引擎一样，Jinja2 具有以下特点：
变量插值：可以在模板中插入变量，并在生成输出时将其替换为实际值。条件语句：可以使用条件语句（如 if、else）在模板中执行不同的操作。循环：支持循环结构，可以对列表、字典等数据进行迭代。模板继承：可以定义模板块，并在多个模板中重复使用这些块。安装 Jinja2要开始使用 Jinja2，首先需要安装它。
可以使用 pip 进行安装，如下所示：
pip install Jinja2安装完成后，就可以在 Python 代码中导入 Jinja2 模块并开始使用它。
基本用法通过一个简单的示例来了解如何使用 Jinja2。假设有一个名为 index.html 的模板文件，其中包含一个变量 name：
<!DOCTYPE html><html><head> <title>Hello World</title></head><body> <h1>Hello, {{ name }}!</h1></body></html>现在，可以使用 Jinja2 将数据插入到这个模板中，并生成最终的 HTML 输出。
以下是 Python 代码示例：
from jinja2 import Template# 定义模板template = Template(open("index.html").read())# 渲染模板output = template.render(name="John")# 打印生成的 HTMLprint(output)运行以上代码将生成以下输出：
<!DOCTYPE html><html><head> <title>Hello World</title></head><body> <h1>Hello, John!</h1></body></html>在上面的示例中，首先导入了 Template 类，然后加载模板文件并使用 render 方法将数据插入模板中。最后，打印生成的 HTML 输出。
变量插值Jinja2 可以在模板中插入变量，并在渲染时将其替换为实际值。变量通常由双大括号 {{ variable_name }} 包围。
以下是一个示例：
<p>My name is {{ name }}</p>在渲染模板时，将 {{ name }} 替换为实际的变量值。
条件语句Jinja2 支持条件语句，可以在模板中使用 if 和 else 来执行不同的操作，具体取决于变量的值。
以下是一个示例：
{% if score >= 90 %} <p>优秀</p>{% elif score >= 60 %} <p>及格</p>{% else %} <p>不及格</p>{% endif %}在上面的示例中，根据变量 score 的值显示不同的消息。
循环Jinja2 支持循环结构，您可以对列表、字典等数据进行迭代。
以下是一个示例：
<ul>{% for item in items %} <li>{{ item }}</li>{% endfor %}</ul>在上面的示例中，对列表 items 中的每个元素进行迭代，并在列表中显示每个元素。
模板继承Jinja2 可以定义模板块，并在多个模板中重复使用这些块。这是一种模板继承的概念，可以使代码更具可维护性。
以下是一个示例：
base.html 模板：
<!DOCTYPE html><html><head> <title>{% block title %}Default Title{% endblock %}</title></head><body> {% block content %}{% endblock %}</body></html>child.html 模板继承 base.html：
{% extends "base.html" %}{% block title %}Custom Title{% endblock %}{% block content %} <h1>Hello World</h1>{% endblock %}在上面的示例中，child.html 模板继承了 base.html 模板，并重写了标题和内容块。这可以轻松地创建具有一致布局的多个页面。
实际应用场景1. Web 框架中的模板渲染Jinja2 在 Web 框架中广泛应用，用于呈现动态内容。以 Flask 为例，展示如何在 Web 应用中使用 Jinja2 渲染模板。
from flask import Flask, render_templateapp = Flask(__name__)@app.route("/")def index(): name = "John" return render_template("index.html", name=name)在上述示例中，使用 Flask 框架创建一个简单的 Web 应用，当访问根路径时，会渲染名为 index.html 的模板，并传递变量 name 给模板。
index.html 模板示例：
<!DOCTYPE html><html><head> <title>Hello World</title></head><body> <h1>Hello, {{ name }}!</h1></body></html>2. 电子邮件模板Jinja2 可以用于创建动态的电子邮件模板，其中包含个性化的信息。以下是一个示例，演示如何使用 Jinja2 创建电子邮件模板并发送电子邮件。
from jinja2 import Templateimport smtplibfrom email.mime.multipart import MIMEMultipartfrom email.mime.text import MIMEText# 电子邮件模板email_template = """<html><body> <p>Hello, {{ recipient_name }}!</p> <p>Your order with ID {{ order_id }} has been shipped.</p></body></html>"""# 使用模板渲染电子邮件内容template = Template(email_template)email_content = template.render(recipient_name="John", order_id="12345")# 发送电子邮件def send_email(subject, to_email, content): # 设置电子邮件服务器信息 smtp_server = "smtp.example.com" smtp_port = 587 sender_email = "your_email@example.com" sender_password = "your_password" # 创建电子邮件消息 msg = MIMEMultipart() msg["From"] = sender_email msg["To"] = to_email msg["Subject"] = subject # 将 HTML 内容添加到消息中 msg.attach(MIMEText(content, "html")) # 连接到电子邮件服务器并发送邮件 with smtplib.SMTP(smtp_server, smtp_port) as server: server.starttls() server.login(sender_email, sender_password) server.sendmail(sender_email, to_email, msg.as_string())# 发送电子邮件send_email("Your Order Shipped", "recipient@example.com", email_content)在上述示例中，创建了一个电子邮件模板，然后使用 Jinja2 渲染电子邮件内容。最后，使用 SMTP 协议发送电子邮件。
3. 报告生成Jinja2 也可以用于生成报告，特别是在需要将数据动态插入到报告模板中时。以下是一个简单的示例，演示如何使用 Jinja2 生成 PDF 报告。
from jinja2 import Templatefrom fpdf import FPDF# 报告模板report_template = """Report for {{ user_name }}{% for item in items %}- {{ item }}{% endfor %}"""# 使用模板渲染报告内容template = Template(report_template)report_content = template.render(user_name="John", items=["Item 1", "Item 2", "Item 3"])# 生成 PDF 报告class PDF(FPDF): def header(self): self.set_font("Arial", "B", 12) self.cell(0, 10, "Report", 0, 1, "C") def footer(self): self.set_y(-15) self.set_font("Arial", "I", 8) self.cell(0, 10, f"Page {self.page_no()}", 0, 0, "C")pdf = PDF()pdf.add_page()pdf.set_font("Arial", size=12)pdf.multi_cell(0, 10, report_content)pdf.output("report.pdf")在上述示例中，创建了一个报告模板，然后使用 Jinja2 渲染报告内容。接下来，使用 FPDF 库生成 PDF 报告，将报告内容插入到 PDF 中。
总结本文深入介绍了 Jinja2 模板引擎，并提供了多个实际应用场景的示例代码。无论是开发 Web 应用、发送电子邮件、生成报告还是处理其他动态内容呈现的任务，Jinja2 都是一个强大的工具，可帮助简化模板化工作。
