JavaWeb模板引擎搭建教程

本文深入浅出地讲解了在Java Web（尤其是Spring Boot）项目中快速搭建和配置Thymeleaf模板引擎的完整流程，涵盖选型依据、Maven依赖引入、标准目录约定（如templates路径）、控制器视图返回机制、Model数据传递、URL重写语法，以及关键的开发与生产配置项（如缓存控制、编码设置和安全集成），突出Thymeleaf因HTML友好、语法简洁、与Spring深度契合而成为当前主流推荐方案，同时简要对比Freemarker、JSP等替代选项，为开发者提供即学即用、避坑高效的实践指南。

在Java Web项目中配置模板引擎，核心是选型、引入依赖、注册处理器、配置路径和渲染逻辑。主流选择有Thymeleaf（推荐）、Freemarker、JSP（传统但逐渐淘汰）和Velocity。下面以Spring Boot + Thymeleaf为例，说明如何快速搭建并解析关键配置。

添加模板引擎依赖

使用Maven，在pom.xml中加入Thymeleaf starter：

• Spring Boot 3.x（基于Jakarta EE）用：spring-boot-starter-thymeleaf
• 自动启用Thymeleaf默认配置，无需额外XML或JavaConfig即可运行
• 若需兼容HTML5严格模式或自定义方言，可额外引入thymeleaf-extras-java8time等扩展

约定目录结构与文件位置

Thymeleaf默认查找路径为src/main/resources/templates/（静态资源走static，模板走templates）：

• HTML文件放在templates/下，如templates/index.html
• 控制器返回字符串"index"时，自动映射到该路径下的index.html
• 可通过spring.thymeleaf.prefix=classpath:/templates/自定义前缀（一般不改）
• spring.thymeleaf.suffix=.html指定后缀，默认即.html，支持.htm、xml等

控制器返回视图的写法

Spring MVC控制器方法返回String视图名，由ViewResolver解析：

• 使用@Controller（非@RestController），方法返回"user/list" → 渲染templates/user/list.html
• 向模板传参用Model或ModelMap：model.addAttribute("users", userList)
• 模板中通过th:text="${users}"或th:each="user : ${users}"访问
• 支持URL重写：th:href="@{/user/{id}(id=${user.id})}"，自动处理上下文路径

常见配置项说明（application.properties）

以下配置影响开发体验和生产行为：

• spring.thymeleaf.cache=false：开发时禁用模板缓存，改完HTML立即生效
• spring.thymeleaf.enabled=true：全局开关，设为false则禁用Thymeleaf自动配置
• spring.thymeleaf.encoding=UTF-8：避免中文乱码，建议显式声明
• spring.thymeleaf.servlet.content-type=text/html：响应Content-Type
• 如集成Spring Security，加thymeleaf-extras-springsecurity6依赖，支持权限标签如sec:authorize

基本上就这些。模板引擎本身不复杂，关键是路径约定、依赖对齐和缓存控制。选Thymeleaf是因为它天然支持HTML原型、语法直观、与Spring生态无缝集成。其他引擎如Freemarker只需替换依赖+调整配置前缀后缀，逻辑类似。

今天关于《JavaWeb模板引擎搭建教程》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！