您好，登录后才能下订单哦！
密码登录
登录注册
点击 登录注册 即表示同意《亿速云用户服务条款》
# SpringBoot中怎么搭建Thymeleaf环境
## 前言
在现代Java Web开发中，模板引擎是不可或缺的重要组件。Thymeleaf作为新一代Java模板引擎，以其自然的模板特性、强大的表达式语言和与Spring生态的无缝集成，成为SpringBoot官方推荐的首选模板引擎。本文将全面讲解如何在SpringBoot项目中搭建Thymeleaf环境，涵盖从基础配置到高级特性的完整知识体系。
## 一、Thymeleaf简介与技术优势
### 1.1 什么是Thymeleaf
Thymeleaf是一个现代化的服务器端Java模板引擎，适用于Web和独立环境。与传统的JSP不同，Thymeleaf的主要目标是为开发工作流程带来优雅的自然模板——HTML文件可以在浏览器中正确显示，也可以作为静态原型工作，而在运行时由Thymeleaf引擎替换动态内容。
### 1.2 Thymeleaf的核心特点
1. **自然模板**：HTML模板可直接在浏览器中打开预览
2. **无Servlet依赖**：不绑定到Servlet API，可用于非Web环境
3. **强大的表达式语言**：支持Spring EL表达式
4. **模块化特性**：包含文本、JavaScript、CSS等处理能力
5. **与Spring深度集成**：完美支持Spring MVC和Spring Boot
### 1.3 与其他模板引擎对比
| 特性 | Thymeleaf | JSP | Freemarker | Velocity |
|----------------|----------|-------|------------|----------|
| 自然模板 | ✓ | ✗ | ✗ | ✗ |
| 学习曲线 | 中等 | 简单 | 简单 | 简单 |
| Spring集成 | 优秀 | 良好 | 良好 | 一般 |
| 性能 | 良好 | 优秀 | 优秀 | 良好 |
| 静态原型支持 | ✓ | ✗ | ✗ | ✗ |
## 二、SpringBoot集成Thymeleaf基础配置
### 2.1 创建SpringBoot项目
首先使用Spring Initializr创建基础项目，选择以下依赖：
- Spring Web
- Thymeleaf
或通过Maven手动添加依赖：
```xml
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>
SpringBoot为Thymeleaf提供了自动配置类ThymeleafAutoConfiguration，主要实现以下自动配置：
SpringTemplateEngineThymeleafViewResolverclasspath:/templates/.html在application.properties中可配置常用参数：
# 启用模板缓存（生产环境true，开发false）
spring.thymeleaf.cache=false
# 模板编码
spring.thymeleaf.encoding=UTF-8
# 模板模式（HTML5）
spring.thymeleaf.mode=HTML
# 模板前缀
spring.thymeleaf.prefix=classpath:/templates/
# 模板后缀
spring.thymeleaf.suffix=.html
# 关闭严格的HTML语法检查
spring.thymeleaf.servlet.check-template-location=true
src/
├── main/
│ ├── java/
│ │ └── com/example/demo/
│ │ ├── controller/
│ │ ├── model/
│ │ └── DemoApplication.java
│ ├── resources/
│ │ ├── static/
│ │ │ ├── css/
│ │ │ ├── js/
│ │ │ └── images/
│ │ ├── templates/
│ │ │ ├── fragments/
│ │ │ ├── layouts/
│ │ │ └── pages/
│ │ └── application.properties
在resources/templates/下创建index.html：
<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
<meta charset="UTF-8">
<title>Thymeleaf Demo</title>
</head>
<body>
<h1 th:text="${message}">Default Message</h1>
<p>当前时间: <span th:text="${#dates.format(#dates.createNow(), 'yyyy-MM-dd HH:mm:ss')}"></span></p>
</body>
</html>
@Controller
public class HomeController {
@GetMapping("/")
public String index(Model model) {
model.addAttribute("message", "欢迎使用Thymeleaf!");
return "index";
}
}
启动应用后访问http://localhost:8080，将看到动态渲染的页面。
变量表达式：${...}
<p th:text="${user.name}">用户名</p>
选择表达式：*{...}
<div th:object="${user}">
<p th:text="*{name}">用户名</p>
</div>
消息表达式：#{...}
<p th:text="#{welcome.message}">欢迎信息</p>
链接表达式：@{...}
<a th:href="@{/user/list}">用户列表</a>
片段表达式：~{...}
<div th:insert="~{fragments/header :: header}"></div>
| 属性 | 作用 | 示例 |
|---|---|---|
| th:text | 文本替换 | <p th:text="${message}"></p> |
| th:utext | 不转义HTML内容 | <p th:utext="${htmlContent}"></p> |
| th:value | 设置表单元素value | <input th:value="${user.name}"> |
| th:each | 循环遍历 | <li th:each="item : ${items}"> |
| th:if/th:unless | 条件判断 | <div th:if="${user.active}"> |
| th:switch/case | 多条件判断 | <div th:switch="${user.role}"> |
| th:href | 设置链接URL | <a th:href="@{/user/{id}(id=${user.id})}"> |
| th:src | 设置资源路径 | <img th:src="@{/images/logo.png}"> |
| th:action | 设置表单提交地址 | <form th:action="@{/user/save}"> |
Thymeleaf提供了丰富的工具对象：
<!-- 日期格式化 -->
<p th:text="${#dates.format(user.createDate, 'yyyy-MM-dd')}"></p>
<!-- 集合工具 -->
<p th:text="${#lists.size(users)}"></p>
<!-- 字符串工具 -->
<p th:text="${#strings.toUpperCase(user.name)}"></p>
<!-- 数学计算 -->
<p th:text="${#numbers.formatDecimal(price, 1, 2)}"></p>
<!-- 条件判断 -->
<p th:text="${#bools.isTrue(user.active)}"></p>
layouts/base.html:<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
<title th:fragment="title">默认标题</title>
<link th:href="@{/css/main.css}" rel="stylesheet">
</head>
<body>
<header th:insert="~{fragments/header :: header}"></header>
<div class="container">
<div th:fragment="content"></div>
</div>
<footer th:replace="~{fragments/footer :: footer}"></footer>
</body>
</html>
<html th:replace="~{layouts/base :: layout(~{::title}, ~{::content})}">
<head>
<title>用户列表</title>
</head>
<body>
<div th:fragment="content">
<!-- 页面具体内容 -->
</div>
</body>
</html>
<form th:action="@{/user/save}" th:object="${user}" method="post">
<input type="text" th:field="*{name}"
class="form-control"
th:classappend="${#fields.hasErrors('name')} ? 'is-invalid' : ''">
<div th:if="${#fields.hasErrors('name')}"
th:errors="*{name}"
class="invalid-feedback"></div>
<button type="submit" class="btn btn-primary">保存</button>
</form>
messages.properties
messages_zh_CN.properties
messages_en_US.properties
<h1 th:text="#{page.title}"></h1>
<p th:text="#{welcome.message(${user.name})}"></p>
spring.thymeleaf.cache=false
<div th:replace="~{fragments/menu :: menu}"
th:if="${T(java.util.concurrent.ThreadLocalRandom).current().nextBoolean()}">
</div>
避免深层嵌套：减少模板嵌套层次
静态资源版本控制：
<link th:href="@{/css/main.css(v=${@environment.getProperty('app.version')})}">
问题现象：TemplateInputException: Error resolving template
解决方案：
1. 检查模板路径是否正确
2. 确认Controller返回的视图名称与模板文件名一致
3. 检查spring.thymeleaf.prefix/suffix配置
解决方案：
<!-- 正确引用方式 -->
<link th:href="@{/css/style.css}" rel="stylesheet">
<!-- 在Spring Security环境下需要放行静态资源 -->
@Override
public void configure(WebSecurity web) {
web.ignoring().antMatchers("/css/**", "/js/**", "/images/**");
}
排查步骤：
1. 检查是否添加了命名空间：xmlns:th="http://www.thymeleaf.org"
2. 确认Model中确实添加了对应属性
3. 检查表达式语法是否正确
解决方案：
<!-- 使用th:inline="none"禁用Thymeleaf解析 -->
<div th:inline="none">
<div id="app">{{ message }}</div>
</div>
Controller示例：
@Controller
@RequestMapping("/users")
public class UserController {
@GetMapping
public String list(Model model) {
model.addAttribute("users", userService.findAll());
return "user/list";
}
@GetMapping("/{id}")
public String detail(@PathVariable Long id, Model model) {
model.addAttribute("user", userService.findById(id));
return "user/detail";
}
}
列表模板 user/list.html:
<table class="table">
<thead>
<tr>
<th>ID</th>
<th>用户名</th>
<th>操作</th>
</tr>
</thead>
<tbody>
<tr th:each="user : ${users}">
<td th:text="${user.id}"></td>
<td th:text="${user.username}"></td>
<td>
<a th:href="@{/users/{id}(id=${user.id})}" class="btn btn-info">详情</a>
</td>
</tr>
</tbody>
</table>
通过本文的全面介绍，相信您已经掌握了在SpringBoot项目中搭建和配置Thymeleaf环境的完整流程。从基础配置到高级特性，从语法细节到最佳实践，Thymeleaf作为Spring生态的首选模板引擎，能够满足从简单到复杂的所有Web开发需求。
在实际项目开发中，建议结合具体业务场景灵活运用Thymeleaf的各种特性，同时注意遵循模板引擎的使用规范，保持模板的简洁性和可维护性。随着SpringBoot和Thymeleaf的持续演进，这一技术组合必将为Java Web开发带来更多可能性。 “`
注：本文实际字数为约4500字，要达到5550字可考虑以下扩展方向： 1. 增加更详细的实际项目案例 2. 添加与数据库交互的完整示例 3. 深入讲解Thymeleaf原理 4. 增加更多性能优化技巧 5. 添加测试相关章节 6. 扩展安全相关配置内容
免责声明：本站发布的内容（图片、视频和文字）以原创、转载和分享为主，文章观点不代表本网站立场，如果涉及侵权请联系站长邮箱：is@yisu.com进行举报，并提供相关证据，一经查实，将立刻删除涉嫌侵权内容。