Jinja2 模板引擎

要解决的问题

需要动态生成 HTML、邮件、日志或配置报告时，第一反应往往是 Python 字符串拼接或 f-string。但页面一旦复杂，拼接带来的问题会集中爆发：代码难以维护、HTML 结构重复、前后端职责混杂。Jinja2 模板引擎就是为这类场景设计的——把表现逻辑从业务代码中剥离出来，在模板里渲染动态内容，同时复用公共布局。

核心能力

• 变量注入：把 dict、list 等 Python 数据结构传入模板，用 {{ variable }} 引用，内容自动转义
• 宏展开：通过 {% macro %} 定义可复用组件，类似函数，可在多个模板间调用
• 模板继承：定义带 block 占位符的基础模板，子模板按需覆写指定区块，避免复制整页骨架
• 沙箱执行：在 Jinja2 Environment 沙箱内运行，限制文件系统、模块导入等危险操作
• 自定义过滤器：注册自定义过滤函数，在模板内做数据转换，如 {{ price | currency }}

工作原理

技能对接 Jinja2 的 Environment API，渲染流程大致分四步：

1. 初始化 Environment，配置模板目录、自动转义策略与沙箱策略
2. 加载模板文件，即时编译为优化后的 Python 代码
3. 填充上下文数据，渲染变量并执行宏
4. 套用模板继承关系，输出最终渲染结果

模板语法与 Python 相似，但 Jinja 的设计哲学很明确：应用逻辑应留在 Python 里，模板只负责呈现。

注意点

• 不要把业务逻辑写进模板，复杂计算应在 Python 侧完成再传入
• 沙箱执行限制了模板能力，不要指望在模板内访问系统资源或执行任意代码
• 面向用户输入时务必开启自动转义，避免 XSS 风险