在传统服务端渲染的Web开发模式中，模板引擎扮演着动态生成HTML页面的核心角色。在Java生态中，Spring Boot官方推荐的Thymeleaf与久经考验的FreeMarker，是两款最为流行的选择。本文将从语法特性、配置集成、布局管理及性能表现等多个维度，对二者进行深入对比，为你的项目选型提供清晰参考。
一、核心定位与设计哲学
模板引擎的核心作用是充当数据与视图之间的桥梁，通过特定的模板语法将后端数据动态渲染为最终的HTML页面。Thymeleaf与FreeMarker在设计理念上各有侧重：
- Thymeleaf：以“自然模板” 为核心理念。其模板文件是合法的HTML，可以直接在浏览器中打开并预览静态原型，对前端开发者极其友好，极大地便利了前后端协作开发流程。
- FreeMarker：一款经典、独立的模板引擎。其语法简洁而强大，尤其擅长处理复杂的数据结构，凭借编译后缓存等机制，在运行时拥有优异的性能表现，在大量传统企业级项目中广泛应用。
两者在Spring Boot中均享有完善的自动配置支持，只需引入对应的Starter依赖即可快速集成，降低了使用门槛。
二、Thymeleaf 语法：自然模板的优雅实践
Thymeleaf最大的优势在于其对原生HTML的零侵入性，所有动态逻辑均通过HTML标签属性（以 th:* 开头）实现，这使得模板文件既是动态视图，也是可预览的静态页面。
1. 基础配置
在pom.xml中引入Spring Boot官方整合依赖：
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>
在HTML文件中声明Thymeleaf命名空间以启用语法：
<html lang="zh-CN" xmlns:th="http://www.thymeleaf.org">
2. 核心语法示例
（1）数据渲染
（2）条件判断
<div th:if="${user.vip}">尊贵的VIP用户</div>
<div th:unless="${user.active}">该用户已停用</div>
（3）循环遍历
th:each支持状态变量，方便获取迭代信息。
<ul>
<li th:each="item, stat : ${itemList}"
th:text="${stat.count} + '. ' + ${item.name}">
</li>
</ul>
（4）URL与资源链接
@{}语法能自动处理应用上下文路径，避免硬编码。
<a th:href="@{/article/{id}(id=${article.id})}">阅读全文</a>
<img th:src="@{/static/images/logo.png}">
3. 特点总结
- 无侵入HTML，模板可独立预览，协作效率高。
- 语法语义化强，学习曲线平缓。
- 内置强大工具对象，便于日期、字符串等常见操作。
三、FreeMarker 语法：简洁高效的数据驱动
FreeMarker采用独立的${}和<#...>指令语法，不依赖于HTML，因此它可以用于生成任何文本格式（HTML、XML、JSON、代码等），在数据处理方面更为灵活。
1. 基础配置
引入Starter依赖：
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-freemarker</artifactId>
</dependency>
常用配置（application.yml）：
spring:
freemarker:
suffix: .ftl
template-loader-path: classpath:/templates/
charset: UTF-8
settings:
default_encoding: UTF-8
number_format: 0.##
2. 核心语法示例
（1）数据渲染与表达式
${}内支持复杂的表达式运算。
<p>用户：${user.name}， 明年年龄：${user.age + 1}</p>
（2）条件判断
<#if user.score >= 90>
<span>优秀</span>
<#elseif user.score >= 60>
<span>及格</span>
<#else>
<span>加油</span>
</#if>
（3）循环遍历
#list指令便于遍历，并能优雅处理空集合。
<#list users as user>
<li>${user_index + 1}. ${user.name}</li>
<#else>
<li>当前暂无用户</li>
</#list>
（4）模板注释
FreeMarker注释不会输出到最终结果。
<#-- 这是FTL注释，用户看不到 -->
<!-- 这是HTML注释，用户可以看到 -->
3. 特点总结
- 语法简洁直接，逻辑表达能力强。
- 文本格式无关，应用场景广泛。
- 性能出色，模板编译后缓存，适合高性能要求场景。
四、布局与片段复用
实现页面公共部分（如页头、页脚）的复用是模板引擎的重要能力。
1. Thymeleaf：th:fragment 与 th:replace
定义片段 (common/footer.html)：
<div th:fragment="siteFooter">
<p>© 2025 公司名称. All Rights Reserved.</p>
</div>
引用片段：
<div th:replace="~{common/footer :: siteFooter}"></div>
2. FreeMarker：#include, #import 与 #macro
FreeMarker提供了不同粒度的复用方式。
五、综合对比与选型指南
| 特性维度 |
Thymeleaf |
FreeMarker |
| 模板特性 |
自然模板，可直接在浏览器预览 |
非自然模板，需渲染后查看 |
| 语法风格 |
基于HTML属性，语义化强 |
基于自定义指令，简洁灵活 |
| 布局管理 |
原生支持片段引用，复杂布局需方言 |
内置#include、#macro，功能强大 |
| 性能表现 |
渲染性能中等 |
编译后缓存，渲染性能高 |
| 学习成本 |
较低，前端友好 |
中等，需记忆指令集 |
| 适用场景 |
前后端协作、中小型项目、快速原型 |
高并发场景、复杂数据处理、传统企业应用 |
选型建议
- 选择 Thymeleaf 当：项目强调前后端分离协作、希望模板能直接预览、或团队中HTML/CSS开发者较多时。
- 选择 FreeMarker 当：项目对渲染性能有较高要求、需要处理复杂的业务逻辑与数据转换、或项目属于后端主导的传统架构时。
六、总结
Thymeleaf与FreeMarker皆是Java Web开发中值得信赖的模板引擎。Thymeleaf以其“自然模板”理念胜在开发体验与协作效率；FreeMarker则凭借其简洁语法与卓越性能，在需要处理大量逻辑和高并发的场景中更具优势。
在Spring Boot的加持下，两者都能实现开箱即用。最终的选型决策，应基于项目具体的性能要求、团队技术栈背景以及主要的开发协作模式来综合考量。
发表于 3 天前
|
查看: 8|
回复: 0
