Thymeleaf 是一个非常流行的 Java 模板引擎，广泛应用于 Spring Boot 中，主要用于生成动态网页内容。作为一种现代的模板引擎，Thymeleaf 与 Spring Boot 的集成提供了强大的功能，支持开发人员通过灵活的方式渲染 HTML 内容，同时保持代码的整洁和可维护性。本文将深入探讨 Thymeleaf 在 Spring Boot 中的使用，包括其基本配置、语法规则、常见功能的使用场景等，帮助开发者更好地掌握和应用 Thymeleaf。

一、Thymeleaf 简介

Thymeleaf 是一个功能强大的 Java 模板引擎，能够以 HTML、XML、JavaScript、CSS 等格式处理模板。与传统的 JSP 模板相比，Thymeleaf 更加关注模板的可读性和易用性，它不仅可以在服务器端进行模板渲染，还能在浏览器端进行渲染，具有很好的开发体验。

Thymeleaf 的优势在于其与 HTML 语法高度兼容，可以直接在 HTML 文件中嵌入 Thymeleaf 标签，且不依赖于复杂的表达式语言。它通过一种非常自然的方式将动态数据插入到模板中，支持强大的条件判断、循环、属性动态绑定等功能，非常适合与 Spring Boot 一起使用。

二、在 Spring Boot 中集成 Thymeleaf

Spring Boot 集成 Thymeleaf 非常简单，只需要在项目中引入相应的依赖并做简单的配置，就能够快速启动 Thymeleaf 模板引擎。

首先，在 Spring Boot 项目中添加 Thymeleaf 的 Maven 依赖。打开 "pom.xml" 文件，添加以下代码：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>

Spring Boot 会自动配置 Thymeleaf，因此你无需手动配置视图解析器等常见的模板引擎配置。只要添加了依赖，Spring Boot 就会默认启用 Thymeleaf 模板引擎，且视图文件（如 "html" 文件）默认存放在 "src/main/resources/templates/" 目录下。

三、Thymeleaf 模板语法

Thymeleaf 提供了丰富的语法，帮助开发者在 HTML 模板中动态渲染数据。下面将介绍一些常见的 Thymeleaf 语法：

1. 属性值的动态赋值

在 Thymeleaf 中，常见的动态操作是对 HTML 属性值的替换。比如我们可以动态设置元素的 "href"、"src"、"alt" 等属性值。

<a th:href="@{http://www.example.com}">点击这里</a>

在这个例子中，"th:href" 会将 "href" 属性值动态设置为 "http://www.example.com"。这种语法是 Thymeleaf 语法的基础，它允许你轻松将动态内容嵌入 HTML 元素的属性中。

2. 条件判断

Thymeleaf 支持常见的条件判断逻辑，可以根据不同的条件显示不同的内容。

<p th:if="${user != null}">欢迎，<span th:text="${user.name}">用户名</span>!<p th:unless="${user != null}">请登录

在上面的代码中，"th:if" 标签用于判断 "user" 对象是否为 "null"，如果不为 "null"，则显示欢迎信息，否则显示请登录提示。

3. 循环

在 Thymeleaf 中，可以通过 "th:each" 标签实现循环遍历数据集合。

<ul>
    <li th:each="item : ${items}" th:text="${item}"></ul>

以上代码会遍历 "items" 集合中的每一个元素，并将其内容显示在 "

" 元素中。"th:each" 标签非常适用于显示列表或表格等场景。

4. 字符串拼接

Thymeleaf 还提供了对字符串的拼接支持，可以将多个字符串合并在一起。

<p th:text="'Hello ' + ${user.name} + '!'">Hello, User!

在这个例子中，Thymeleaf 将字符串 "Hello" 与 "${user.name}" 的值进行拼接，最终输出一个包含用户名的问候语。

四、Thymeleaf 与 Spring Boot 控制器的结合

在 Spring Boot 中，Thymeleaf 的模板引擎可以与控制器（Controller）配合使用。控制器负责处理请求并将数据传递给模板，模板则负责将数据渲染到前端页面。

下面是一个简单的控制器例子，它会将数据传递给 Thymeleaf 模板：

@Controller
public class UserController {
    @GetMapping("/user")
    public String getUser(Model model) {
        User user = new User("Tom", 25);
        model.addAttribute("user", user);
        return "user";
    }
}

在这个例子中，我们定义了一个 "UserController"，它处理 "/user" 路径的 GET 请求，并通过 "model.addAttribute" 将 "user" 对象传递给视图模板 "user.html"。

五、Thymeleaf 高级功能

Thymeleaf 提供了许多高级功能，帮助开发者更高效地进行模板渲染。

1. 国际化支持

Thymeleaf 内建对国际化的支持，可以根据用户的语言环境显示不同的内容。

<p th:text="#{welcome.message}">Welcome

在这个例子中，"#{welcome.message}" 表示从资源文件中获取对应的国际化消息。你只需要在 "messages.properties" 文件中定义 "welcome.message" 的内容即可。

2. 内置变量与工具

Thymeleaf 提供了一些内置的工具，可以在模板中直接使用。例如，你可以通过 "#dates" 工具类来格式化日期：

<p th:text="${#dates.format(user.registrationDate, 'yyyy-MM-dd')}">2025-02-22

这段代码会将 "user.registrationDate" 格式化为 "yyyy-MM-dd" 格式的日期。

六、调试与性能优化

在开发过程中，调试 Thymeleaf 模板有时会遇到一些问题。为了帮助开发者更好地调试和优化模板，Spring Boot 提供了一些相关的配置。

你可以在 "application.properties" 文件中启用 Thymeleaf 模板的调试模式：

spring.thymeleaf.cache=false

禁用模板缓存后，修改模板文件时不需要重启应用即可看到更新的效果，适用于开发阶段。

七、总结

Thymeleaf 是一个功能强大且易于使用的模板引擎，它与 Spring Boot 的结合可以帮助开发者快速构建动态的 Web 应用。通过对 Thymeleaf 基本语法、控制器配合、国际化支持以及性能优化等方面的了解，开发者能够高效地使用 Thymeleaf 来实现丰富的前端功能。

在实际应用中，Thymeleaf 的简单易用和灵活性使得它成为了许多 Java Web 项目的首选模板引擎。希望本文对你了解和使用 Thymeleaf 在 Spring Boot 中的应用有所帮助。