spring boot 中使用 thymeleaf 渲染网页需添加 starter 依赖、控制器返回视图名(如 "home" 对应 templates/home.html)、html 模板声明 th 命名空间并用 th:text/th:if/@{} 等语法绑定数据,开发时可设 spring.thymeleaf.cache=false。

在 Spring Boot 中使用 Thymeleaf 渲染服务端网页,核心是配置依赖、启用模板引擎、编写控制器返回视图名、并在 templates 目录下放置 HTML 模板文件。Thymeleaf 默认与 Spring Boot 集成良好,开箱即用。
添加 Thymeleaf 依赖
确保 pom.xml 中包含 Spring Boot 的 Thymeleaf Starter:
无需额外配置即可运行,默认会自动扫描 src/main/resources/templates/ 下的 HTML 文件。
编写控制器返回视图名
控制器方法不返回 JSON,而是返回字符串(视图名),Spring MVC 会将其解析为 Thymeleaf 模板路径:
- 返回
"index"→ 对应templates/index.html - 返回
"user/detail"→ 对应templates/user/detail.html
示例:
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式,或要求按照代码注释规范处理 Java 文件时,使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则,并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括:补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
public String home(Model model) {
model.addAttribute("name", "张三");
return "home"; // 自动匹配 templates/home.html
}
在 HTML 模板中使用 Thymeleaf 语法
在 .html 文件顶部声明命名空间,启用 Thymeleaf 解析:
常用语法示例:
-
<span th:text="${name}">默认文本</span>→ 替换为模型中的name值 -
<div th:if="${user != null}">已登录</div>→ 条件渲染 -
<a th:href="@{/user/{id}(id=${user.id})}">详情</a>→ 构建带参数的 URL
可选:自定义 Thymeleaf 配置
如需修改默认行为(如关闭缓存便于开发),可在 application.properties 中配置:
spring.thymeleaf.cache=false
# 设置前缀和后缀(默认已配置好)
spring.thymeleaf.prefix=classpath:/templates/
spring.thymeleaf.suffix=.html
一般无需改动,仅在特殊路径或调试时调整。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










