返回资讯中心
外部精选
软件工程
#开发者实时流

django-rust-templates:用 Rust 重写 Django 模板引擎,渲染速度提升约15倍

来源标题:Django-rust-templates – A drop-in Rust replacement for Django's template engine

django-rust-templates 发布了 0.1 版,用 Rust 原生重实现了 Django 模板引擎,可直接替换 DjangoTemplates 后端。该项目称其输出与原生 Django 逐字节一致,并通过 Django 5.2 和 6.1 的全部模板测试套件,基准测试中渲染约快 15 倍、编译约快 12 倍。目前仍处于早期阶段,尚未经过广泛生产环境验证。

Hacker News 最新jonatron2026/11/12 · 5 天前25 分钟阅读

以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。

Django 模板引擎的直接替代方案,用 Rust 编写。它原生重新实现了 Django 模板语言:词法分析器、解析器、节点树、渲染器,以及内置标签和过滤器。它的输出与原生 Django 逐字节相同,并在 Django 5.2 和 6.1 上通过了 Django 自身模板测试套件的 100%。在下面的基准测试中,它的渲染速度约为原生 Django 的 15 倍,模板编译速度约为 12 倍。

TEMPLATES = [
 "BACKEND": "django_rust_templates.RustTemplates", # was django.template.backends.django.DjangoTemplates
 "DIRS": [BASE_DIR / "templates"],
 "APP_DIRS": True,
 "OPTIONS": {"context_processors": [...]}, # same options as DjangoTemplates

状态:早期阶段(0.1)。正确性以 Django 自身的测试套件为门槛,但该项目尚未经过大规模生产使用。

安装 用法 兼容性 性能 测试 工作原理 开发 许可证

安装

pip install django-rust-templates

为 CPython 3.12、3.13 和 3.14 在 Linux x86_64 和 aarch64 上发布了预编译 wheel(manylinux glibc ≥ 2.28 和 musllinux)。它要求 Django ≥ 5.2。

在其他平台上,pip 会回退到源码分发,或者你可以从 git 构建。无论哪种方式,你都需要 Rust 工具链(rustup;rust-toolchain.toml 中固定的版本会自动安装)以及 Python ≥ 3.12。

pip install git+https://github.com/MasonLyons/rust-django-template-engine.git

或者从检出目录安装:

git clone https://github.com/MasonLyons/rust-django-template-engine.git
cd rust-django-template-engine
pip install .

用法

作为 Django 后端

在 TEMPLATES 中替换 BACKEND(见上文)。RustTemplates 接受与 DjangoTemplates 相同的 DIRS、APP_DIRS 和 OPTIONS:context_processors、debug、loaders、string_if_invalid、file_charset、libraries、builtins 和 autoescape。render()、render_to_string()、模板加载器、{% load %} 以及你的自定义标签库都可以照常工作。

Django 通过 FORM_RENDERER 渲染表单和控件({{ form }}、{{ field }}、form.as_div),其默认实现构建自己的原生模板引擎,因此表单 HTML 根本不会经过 TEMPLATES。要让它也原生渲染:

FORM_RENDERER = "django_rust_templates.forms.RustFormRenderer"

它加载与 Django 默认 DjangoTemplates 渲染器相同的内置表单模板(以及每个应用的 templates 目录),因此输出完全相同。渲染一个 8 字段的表单大约快 2.6 倍;其余时间花在 Django 自身的表单和控件代码上。

Engine 镜像 django.template.Engine(与原生引擎一样,必须配置 Django settings):

from django.template import Context
from django_rust_templates import Engine
engine = Engine(dirs=["templates"], libraries={"mytags": "myapp.templatetags.mytags"})
template = engine.from_string("Hello {{ user.name|title }}!")
template.render(Context({"user": {"name": "ada lovelace"}})) # 'Hello Ada Lovelace!'

兼容性

项目 支持情况
Django 5.2 LTS、6.1
Python 3.12、3.13、3.14
平台 Linux x86_64 和 aarch64(例如 AWS Graviton),已在 CI 中测试;任何 Rust 和 PyO3 支持的目标都应该可以构建

输出一致性。渲染输出、错误类型和错误消息(包括行号以及 Django 6.1 的 Template: name, prefix)与原生 Django 完全一致。任何差异都是 bug,请提交 issue。

内置标签和过滤器原生运行,包括 extends/block、include、for、if、with、cycle、url、csrf_token、Django 6.1 的 partialdef/partial、{% translate "literal" %}、{% blocktranslate %}、{% static %},以及 date、floatformat、urlize、join、striptags、truncatechars_html/truncatewords_html 和 filesizeformat 等过滤器,外加 humanize 的 naturaltime,以及针对整数的 intcomma、intword 和 ordinal。

自定义和第三方标签库继续可用。simple_tag 和 inclusion_tag 在原生辅助节点上运行。其他标签(自定义编译函数、simple_block_tag)会桥接到其 Python 实现,因此它们自己的代码以 Python 速度运行,而模板的其余部分保持原生。当桥接的块标签(例如 {% localtime %}、{% cache %}、simple_block_tag)调用 parser.parse() 时,其主体在 Rust 解析器上编译并原生渲染。

Python 节点 API(template.nodelist、get_nodes_by_type、render_annotated)通过兼容原生实现的适配器节点暴露,因此检查已编译模板的工具可以继续工作。

性能

每次操作的微秒数;越低越好。× 是相对于原生 Django 的加速比。

Linux x86_64(AMD EPYC 7601),Python 3.13.15,Django 6.1.2,release 构建。

方法论。benchmarks/bench.py 首先在两个引擎上渲染每个场景,除非输出逐字节相同否则中止,因为错误输出上的加速毫无价值。然后它在各自的子进程中为每个引擎计时(这样两者都不会继承对方的分配器或 GC 状态),固定到一个 CPU 核心,并报告 7 次 timeit 重复的最小值。"Compile" 是一次模板解析。在 cached_extends 和 realistic_page(缓存加载器)中,它是缓存命中的 get_template(),即生产环境中的每请求成本。

HTML 转义和词法分析器的标签扫描器使用可移植 SIMD:fearless_simd 在 x86_64 上选择 SSE2,在 aarch64 上选择 NEON,memchr 在运行时选择最佳指令集。

Django 还附带一个 Jinja2 后端,当 DTL 太慢时,Jinja2 是常见选择。benchmarks/jinja2_bench.py 通过全部三个引擎运行相同的场景。每个场景都有一个手写的 Jinja2 模板,以惯用的 Jinja2(loop.cycle、super()、p.full())完成相同的工作,除非所有三个输出逐字节匹配,否则脚本会中止。唯一的例外是实体的拼写方式:markupsafe 写 ' 而 Django 写 '。

与上述相同的机器;Jinja2 3.1.6。在相同行上,Jinja2 的渲染速度是原生 Django 的 3.35 倍,而此引擎的渲染速度是 16.54 倍。

maturin develop --release
python benchmarks/bench.py # full table
python benchmarks/bench.py --only realistic # filter scenarios
python benchmarks/realworld.py # end-to-end page via the backend
python benchmarks/jinja2_bench.py # stock vs Jinja2 vs Rust (pip install jinja2)

(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →