本文将通过一个示例介绍怎样去使用 Thymeleaf 模板引擎。下面示例将使用 Spring Boot 快速搭建示例项目，搭建示例的详细步骤如下。
操作系统：Windows11
JDK版本：JDK 1.8
框架：Spring Boot 2.7.5
使用 IDEA 或者 start.spring.io 在线工具创建一个简单的 Spring Boot 项目，项目 pom 依赖如下：
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.7.5</version>
<relativePath/> <!-- lookup parent from repository -->
</parent>
<groupId>com.hxstrive</groupId>
<artifactId>thymeleaf-spring-boot</artifactId>
<version>0.0.1-SNAPSHOT</version>
<name>thymeleaf-spring-boot</name>
<description>Demo project for Spring Boot</description>
<properties>
<java.version>1.8</java.version>
</properties>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-devtools</artifactId>
<scope>runtime</scope>
<optional>true</optional>
</dependency>
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<optional>true</optional>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>fastjson</artifactId>
<version>1.2.79</version>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<configuration>
<excludes>
<exclude>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
</exclude>
</excludes>
</configuration>
</plugin>
</plugins>
</build>
</project>在创建好的 Spring Boot 项目中，打开启动类，在启动类中映射根（“/”）页面请求，代码如下：
package com.hxstrive.thymeleaf;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import java.util.Map;
/**
* 启动类
* @author Administrator
*/
@Controller
@SpringBootApplication
public class ThymeleafSpringBootApplication {
public static void main(String[] args) {
SpringApplication.run(ThymeleafSpringBootApplication.class, args);
}
// 创建一个页面请求
@RequestMapping("/")
public String index(Map<String,Object> root) {
// 设置一个属性值，名为 title，用来在前段页面获取
root.put("title", "Welcome to learn thymeleaf3.");
return "index.html";
}
}在 Spring Boot 项目的 resources/templates 目录下面创建 index.html 模板页面。内容如下：
<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org/">
<head>
<meta charset="UTF-8">
<title>Thymeleaf模板引擎</title>
</head>
<body>
<!-- 获取后端传递的名为 title 的属性值 -->
<h1 th:text="${title}"></h1>
</body>
</html>注意：上面模板中，在 <html> 标签中通过 xmlns:th 声明了一个命名空间 th，后续所有关于 Thymeleaf 的使用均要通过 th 命名空间来使用。
启动 Spring Boot 项目，在浏览器地址栏输入 http://localhost:8080，效果如下图：
到这里，一个简单的 Thymeleaf 项目就创建完成。
川公网安备51010802032098