Tera模板引擎的用法总结

# 基本设置 ## 添加依赖 使用tera,在toml的dependencies中添加： ```toml [dependencies] tera = "1.19" serde = { version = "1.0", features = ["derive"] } serde_json = "1.0" ``` ## 初始化Tera ```rust use tera::{Tera, Context}; // 从目录加载模板 let tera = Tera::new("templates/**/*").unwrap(); // 或者从字符串创建 let mut tera = Tera::default(); tera.add_raw_template("hello", "Hello {{ name }}!").unwrap(); ``` # 基本用法 ## 1. 简单渲染 ```rust use tera::{Tera, Context}; let mut context = Context::new(); context.insert("name", "世界"); let rendered = tera.render("hello.html", &amp;context).unwrap(); println!("{}", rendered); ``` ## 2. 使用结构体数据 ```rust use serde::Serialize; #[derive(Serialize)] struct User { name: String, age: u32, email: String, } let user = User { name: "张三".to_string(), age: 25, email: "zhangsan@example.com".to_string(), }; let mut context = Context::new(); context.insert("user", &amp;user); ``` # 模板语法 ## 1. 变量输出 ```rust {{ name }} {{ user.name }} {{ items.0 }} {{ name | upper }} {{ price | round(precision=2) }} {{ content | safe }} ``` ## 2. 条件语句 ```rust {% if user.age &gt;= 18 %} <p>成年用户</p> {% elif user.age &gt;= 13 %} <p>青少年用户</p> {% else %} <p>儿童用户</p> {% endif %} ``` ## 3. 循环 ```rust {% for item in items %} <li>{{ item }}</li> {% endfor %} {% for user in users %} {{ loop.index }} {{ user.name }} {% endfor %} {% for item in items %} <li>{{ item }}</li> {% else %} <p>没有项目</p> {% endfor %} ``` ## 4. 模板继承 ```rust {% block title %}默认标题{% endblock %} {% block content %}{% endblock %} {% extends "base.html" %} {% block title %}子页面标题{% endblock %} {% block content %} 这是子页面内容 {% endblock %} ``` ## 5. 包含模板 ```html <!-- header.html --> <header> <h1>网站标题</h1> </header> <!-- main.html --> {% include "header.html" %} <main> <p>主要内容</p> </main> ``` ## 6. 常用过滤器 ```rust {{ text | upper }} {{ text | lower }} {{ text | title }} {{ text | length }} {{ text | truncate(length=10) }} {{ number | round(precision=2) }} {{ price | filesizeformat }} {{ date | date(format="%Y-%m-%d") }} {{ html_content | safe }} ``` # 高级功能 ## 1. 自定义过滤器 ```rust use tera::{Tera, Value, Result as TeraResult}; use std::collections::HashMap; fn reverse_filter(value: &amp;Value, _: &amp;HashMap) -&gt; TeraResult { if let Some(s) = value.as_str() { Ok(Value::String(s.chars().rev().collect())) } else { Err("过滤器只能用于字符串".into()) } } let mut tera = Tera::new("templates/**/*").unwrap(); tera.register_filter("reverse", reverse_filter); ``` ## 2. 自定义函数 ```rust use tera::{Tera, Value, Result as TeraResult}; use std::collections::HashMap; fn get_random_number(_args: &amp;HashMap) -&gt; TeraResult { use rand::Rng; let mut rng = rand::thread_rng(); Ok(Value::Number(rng.gen_range(1..=100).into())) } tera.register_function("random", get_random_number); ``` ## 3. 全局变量 ```rust let mut context = Context::new(); context.insert("site_name", "我的网站"); context.insert("current_year", &amp;2024); // 或者使用 Tera 的全局变量 tera.register_global_function("now", || { use chrono::Utc; Ok(Value::String(Utc::now().format("%Y-%m-%d %H:%M:%S").to_string())) }); ``` # 实际应用示例 ## Web应用中的使用 ```rust use tera::{Tera, Context}; use serde::Serialize; #[derive(Serialize)] struct Post { title: String, content: String, author: String, created_at: String, } fn render_blog_page(tera: &amp;Tera, posts: Vec) -&gt; String { let mut context = Context::new(); context.insert("posts", &amp;posts); context.insert("page_title", "博客首页"); tera.render("blog.html", &amp;context).unwrap() } ``` ## 错误处理 ```rust use tera::{Tera, Context, Error}; fn safe_render(tera: &amp;Tera, template: &amp;str, context: &amp;Context) -&gt; Result { match tera.render(template, context) { Ok(rendered) =&gt; Ok(rendered), Err(e) =&gt; { eprintln!("模板渲染错误: {}", e); Err(e) } } } ``` # 性能优化建议 1. ​**预编译模板**​: 在应用启动时加载所有模板 2. ​**缓存 Context**​: 对于重复使用的数据，考虑缓存 Context 3. ​**避免复杂逻辑**​: 将复杂逻辑放在 Rust 代码中，而不是模板中 4. ​**使用合适的过滤器**​: 选择最适合的内置过滤器而不是自定义