Beetl 模板引擎入门

1. 一句话简介

Beetl 是一个高性能的国产 Java 模板引擎，由知乎大 V 闲大赋（李家智）主导开发，核心定位是"快"——同类引擎中渲染性能处于第一梯队。它用 ${var} 输出变量、<% %> 书写控制逻辑（语法风格类似 JSP），并支持模板片段包含、继承、布局等特性。在 Spring Boot 中可通过第三方 starter beetl-framework-starter 零配置集成；本 demo 模块用它实现登录与欢迎页，演示 ${user.name} 变量输出、<% include("/common/head.html"){} %> 模板包含，以及 .btl 后缀的视图约定。

2. 什么时候使用

✅ 适用场景
- 页面渲染性能敏感的 Web 应用：Beetl 主打高性能，适合对首屏/吞吐有较高要求的服务端渲染页面。
- 中文 Java 团队、需要中文文档的项目：Beetl 由国人开发，中文资料和示例完善，团队内部传递成本低。
- 习惯 JSP 风格语法的团队：Beetl 的 ${var} 输出与 <% %> 控制语句和 JSP 高度相似，老 Java 开发者上手快。
- 需要模板包含/布局复用：<% include("路径"){} %> 可抽取公共片段（本 demo 的 head.html 即被 login.btl 和 index.btl 复用）。
- 本地化/对第三方 starter 依赖可接受：愿意引入非 Spring 官方提供的自动配置组件。
- 需要模板直接调用 Java 方法/进行简单逻辑控制：Beetl 支持在模板中调用 Java 对象方法与函数。
❌ 不适用/需谨慎
- 追求 Spring 官方生态兼容性：Beetl 无官方 Spring Boot starter，须依赖社区维护的 beetl-framework-starter，升级与 Spring 版本适配可能存在滞后。
- 国际化/大型团队协作的标准化需求：Beetl 相对小众，国外社区、招聘与生态远不如 Thymeleaf/FreeMarker 丰富，长期维护需评估风险。
- 前端主导、强调模板为纯浏览器的项目：若主要用 Vue/React 等前端渲染，服务端模板引擎（含 Beetl）并不适用。
- 对安全转义有严格要求的公共站点：需自行配置 HTML 转义规则来防 XSS，默认输出形式需额外把控。
- 团队已标准化为某官方引擎：若项目已统一用 Thymeleaf/FreeMarker，为个别页面引入新的渲染引擎会增加栈复杂度。

3. 常见业务场景

服务端渲染的登录/表单页面：如本 demo 所示，Controller 返回 @Controller + ModelAndView，用 Beetl 渲染 login.btl 登录表单，POST 后把 User 存入 Session 并重定向首页。适合需要后端控制重定向、校验与状态的页面。
根据登录态动态展示页面内容：IndexController 中通过 Session 是否含 user 决定跳转登录页还是渲染 page/index.btl 欢迎页，模板里用 ${user.name} 展示当前用户——适合会话驱动的个性化首页、个人中心等。
公共 UI 片段复用：本 demo 将 <head> 元信息提取为 /common/head.html，login.btl 与 index.btl 均通过 <% include("/common/head.html"){} %> 引入，避免重复编写公共导航、页脚、样式引用等。适合多页面共享布局的中小型 MVC 站点。
高性能的内容展示页面：如文章列表、商品页、数据报表等读多写少、以渲染速度换吞吐的场景，可发挥 Beetl 高性能优势。
代码/文档/邮件模板生成：Beetl 支持在模板中调用 Java 方法与简单的循环/条件逻辑，也适用于生成固定格式的邮件、导出报表模板等需 Java 逻辑参与渲染的场景。

4. 同类技术对比

维度	Beetl	FreeMarker	Thymeleaf	JSP
出生背景	国产开源（闲大赋）	Apache 基金会	Spring 官方生态	Java 官方 Servlet 规范
渲染性能	号称同类最快	高	中	低（每次需编译）
语法风格	`${var}` 输出 + `<% %>` 控制（类 JSP）	`${var}` + `<#指令>`	`th:属性`，可静态预览	`<%= %>` + `<% %>`
模板文件后缀	`.btl`，视图名需带后缀	`.ftl`，视图名自动加后缀	`.html`，视图名自动加后缀	`.jsp`
Spring Boot 集成	第三方 starter（`beetl-framework-starter`）	官方 starter	官方 starter	官方 starter + Servlet 容器
中文文档资料	完善（作者国人）	偏英文	偏英文	官方中文多
生态/社区规模	相对小众	大、成熟	大，Spring 强绑定	传统、正在被替代
适用规模	中小型、性能敏感的国产项目	通用中大型项目	通用、Spring 全家桶项目	老项目维护

选型建议： 需要贴近 Spring 官方生态、强调 HTML 静态可预览且 HTML 由前端/设计师维护，选 Thymeleaf；追求成熟稳定、平台无关的通用模板引擎，选 FreeMarker；大型分布式渲染已有标准时，优先遵循团队既有约定。当项目对渲染性能有极致要求、团队以中文为主、且愿意接受第三方 starter 时，Beetl 是极具竞争力的选择，尤其适合追求高吞吐的服务端渲染场景——其近乎 JSP 的语法也能让老 Java 工程师快速上手。整体上，若非性能或中文化特诉求，推荐优先考虑 Thymeleaf/FreeMarker 以换取更稳妥的官方支持与生态。