常见问题

优质

小牛编辑

130浏览

2023-12-01

本页回答了一些关于 Jinja 的常见问题。

为什么叫做 Jinja ？

选择 Jinja 作为名字是因为 Jinja 是日本寺庙的名称，并且 temple 和 template 的发音类似。它并不是以乌干达的金贾市（Jinja）命名的。

它有多快？

我们相当厌烦基准测试，尤其是因为它们并不能影响什么。一个模板的性能取决于许多因素，而你可能需要在不同环境中对不同的引擎做基准测试。测试套件中的基准测试表明， Jinja2 与 Mako 的性能相近，比 Django 的模板引擎或 Genshi 快 10 到 20 倍。这些数字应该相当有刺激性，因为基准测试只测试一些性能相关的场景，比如循环，来获取这些数字。大体上，一个模板引擎的性能几乎不会成为一个 web 应用的瓶颈，而应该是数据库或应用的代码。

Jinja2 与 Django 兼容性如何？

Jinja2 的语法与 Django 的语法很多都匹配。但这并不意味着你可以直接在 Jinja2 中原封不动地使用 Django 模板。例如过滤器参数使用函数调用语法而不是用冒号分隔过滤器名和参数。此外， Jinja 中的扩展接口与 Django 的有根本区别，这意味着你的自定义标签不能再正常工作。

总体而言，因为 Jinja 模板系统允许你使用一个 Python 表达式的特定子集，你会使用相当少的自定义扩展，且可以替代大多数的 Django 扩展。例如，不是用下面的这样:

{% load comments %}
{% get_latest_comments 10 as latest_comments %}
{% for comment in latest_comments %}
    ...
{% endfor %}

你会更可能提供一个对象，用属性来检索数据库中的评论:

{% for comment in models.comments.latest(10) %}
    ...
{% endfor %}

或直接为快速测试提供模型:

{% for comment in Comment.objects.order_by(&"http://pypi.python.org/pypi/MarkupSafe" >MarkupSafe 。

Jinja2 不再伴随一个 C 实现而是纯粹的 Python 实现。无论如何，它会检查是否存在安装好的 MarkupSafe ，如果有，使用 MarkupSafe 的 Markup 类。

所以如果你想加速，只需要导入 MarkupSafe 。

我的回溯看起来很怪异。发生了什么？

如果没有编译调试支持模块并且你在使用一个没有 ctypes 的 Python 安装（ Python 2.4 没有 ctypes ， Jython 或 Google 的 AppEngine ） Jinja2 不能提供正确的调试信息，且回溯可能是不完整的。这也是为什么现在不能与 Jython 或是 AppEngine 良好工作的原因，没有 ctypes 就不可能使用调试支持扩展。

如果你在 Google Appengine 开发服务器上工作，你可以把 ctypes 模块添加到白名单来恢复回溯。这无论如何都不能用于生产环境:

import os
if os.environ.get(&"http://stackoverflow.com/questions/3086091/debug-jinja2-in-google-app-engine/3694434" >Thomas Johansson


为什么没有 Python 2.3 支持？
Python 2.3 中缺少许多在 Jinja2 中大量使用的特性。做出这个艰难的决定是因为使用即
将到来的 Python 2.6 和 3.0 版本，再为老版本 Python 维护代码更加困难。如果你确实
需要 Python 2.3 支持，你可以使用 Jinja 1 或其它仍然支持 2.3 的模板引擎。


我的宏被什么东西给覆盖了
在某些情况下， Jinja 的作用域会是任意的:
layout.tmpl:
{% macro foo() %}LAYOUT{% endmacro %}
{% block body %}{% endblock %}


child.tmpl:
{% extends 'layout.tmpl' %}
{% macro foo() %}CHILD{% endmacro %}
{% block body %}{{ foo() }}{% endblock %}


这在 Jinja2 中会打印 LAYOUT 。这是父模板在子模板之后求值的副作用。
这允许子模板传递信息到父模板。要避免这个问题，重命名父模板中的变量或宏
让它们有不同的前缀。