在日常开发 Spring Boot 3 项目的过程中，有没有遇到过这样的困扰：想让 Web 页面展示得更加灵活和动态，可传统的方式又显得捉襟见肘？比如，当我们需要根据不同用户的请求，实时展示不同的数据，或者对页面布局进行多样化的调整时，该怎么办呢？这时候，模板引擎就成为了我们的得力助手。但在 Spring Boot 3 中，众多的模板引擎，到底该如何选择并高效使用呢？别着急，今天咱们就来深入探讨一下。

背景介绍

在软件开发的世界里，尤其是 Web 应用开发，用户界面与业务数据的分离一直是个重要课题。模板引擎的诞生，就是为了解决这个问题，它能够生成特定格式的文档，像咱们常见的 HTML、XML 等。在 Spring Boot 3 的生态系统中，模板引擎更是扮演着关键角色。

就拿咱们熟悉的 JSP 来说，它曾经也是很流行的模板引擎，能写 Java 代码，功能强大。可随着技术的发展，Spring Boot 默认已经不支持它了。现在，有很多优秀的模板引擎可供选择，比如 Freemarer、Thymeleaf 等。Freemarker 通过特定语法，像 ${参数}，能将数据注入模板生成动态内容，很适合生成复杂格式的文件，像 Excel、PDF 文档等。

而 Thymeleaf 呢，它可是 Spring Boot 大力推荐的，特别适合与 Spring MVC 集成的项目，能处理 HTML、XML、JavaScript、CSS 甚至纯文本。Thymeleaf 的优势非常明显。它的模板本质上就是标准的 HTML 文件，直接在浏览器中就能预览，这对于前端开发人员和后端开发人员协作来说，简直太友好了。

而且它与 Spring Boot 无缝对接，能在 HTML 标签内直接插入动态表达式，实现 “模板 + 数据” 的展示方式。当美工在浏览器中查看静态页面效果时，能直观看到页面布局；等服务启动后，后台开发人员又能让页面展示带数据的动态效果。

解决方案

引入 Thymeleaf 依赖

如果我们决定在 Spring Boot 3 项目中使用 Thymeleaf 模板引擎，首先要在项目的 pom.xml 文件中加入 Spring Boot 的 Thymeleaf Starter 依赖。要是用 Maven 构建项目，添加如下依赖就行，如下所示。

    org.springframework.boot
    spring-boot-starter-thymeleaf

配置 Thymeleaf 属性

虽说 Spring Boot 的自动配置已经给了一个合理的默认配置，但我们还是可以通过 application.properties 或 application.yml 文件来自定义 Thymeleaf 的一些属性。比如：

# 设置Thymeleaf模板文件的前缀位置（默认是`src/main/resources/templates`）
spring.thymeleaf.prefix=classpath:/templates/
# 设置模板文件的后缀（默认是`.html`）
spring.thymeleaf.suffix=.html
# 设置模板模式（默认是HTML5，Thymeleaf 3中为`HTML`）
spring.thymeleaf.mode=HTML
# 开启模板缓存（开发时建议关闭，生产时开启）
spring.thymeleaf.cache=false

在开发阶段，关闭模板缓存能让我们在修改模板文件后，及时看到更新效果，不用再为缓存问题而烦恼。

创建 Thymeleaf 模板

接着，在
src/main/resources/templates 目录下创建 Thymeleaf 模板文件。举个例子，创建一个名为 greeting.html 的模板：

    


    
Hello, World!

这里的 th:text 属性就是 Thymeleaf 的语法，它能动态替换文本内容。

创建一个 Controller

现在，得创建一个 Spring MVC Controller，用来处理用户请求并返回 Thymeleaf 模板视图：

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.GetMapping;

@Controller
public class GreetingController {
    @GetMapping("/greeting")
    public String greeting(@RequestParam(name="name", required=false, defaultValue="World") String name, Model model) {
        model.addAttribute("name", name);
        return "greeting";
    }
}

在这个 Controller 中，greeting 方法处理 /greeting 路径的 GET 请求，接受一个名为 name 的请求参数，把它添加到模型中，然后返回 greeting 作为视图名称，Spring Boot 会自动用 Thymeleaf 解析器解析 greeting.html 模板。

运行应用并访问页面

最后，启动 Spring Boot 应用，在浏览器中访问
http://localhost:8080/greeting，就能看到基于提供的 name 参数（没提供就默认为 “World”）渲染的问候消息啦。

总结

通过上面这些步骤，咱们就能在 Spring Boot 3 项目中顺利使用 Thymeleaf 模板引擎来渲染动态 Web 页面了。这种方式给我们构建交互式 Web 应用提供了强大又灵活的手段。各位后端开发的小伙伴们，赶紧在自己的项目中试试 Thymeleaf 模板引擎吧，说不定会给你带来意想不到的便捷和高效。要是在使用过程中有什么问题或者心得，欢迎在评论区留言分享，咱们一起交流进步。