【亲测免费】 Thymeleaf 入门指南及实战教程

2026-01-19 10:49:28作者：魏侃纯Zoe

项目介绍

Thymeleaf 是一款适用于现代服务器端 Java 环境的模板引擎，它特别适合用于Web和独立环境。Thymeleaf 的核心目标是让开发过程中使用的模板保持优雅和自然——即HTML可以直接在浏览器中显示，并且可以作为静态原型来增强团队协作效率。通过集成Spring框架、支持多种工具的整合以及允许自定义功能插件，Thymeleaf 成为了现代HTML5 JVM Web开发的理想选择，尽管它的能力远不止于此。

项目快速启动

要快速开始使用Thymeleaf，首先确保你的开发环境中已经安装了Java和Maven。接下来，创建一个简单的 Maven 项目，并加入Thymeleaf依赖：

<!-- pom.xml -->
<dependencies>
    <dependency>
        <groupId>org.thymeleaf</groupId>
        <artifactId>thymeleaf-spring5</artifactId>
        <version>3.1.2.RELEASE</version>
    </dependency>
</dependencies>

然后，在资源目录（如src/main/resources/templates）下创建一个名为index.html的文件，添加基本的Thymeleaf语法：

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <title>Hello Thymeleaf!</title>
</head>
<body>
    <h1 th:text="${'Hello ' + #strings.capitalize(#localdatetime.now().toString())}"></h1>
</body>
</html>

接着，在Spring MVC控制器中配置Thymeleaf视图：

@Controller
public class HelloWorldController {

    @GetMapping("/")
    public String welcome(Model model) {
        model.addAttribute("greeting", "World");
        return "index";
    }
}

运行你的应用程序，访问 http://localhost:8080/，你会看到一个动态问候页面：“Hello [当前时间的小时和分钟]”。

应用案例和最佳实践

案例一：条件渲染

在Thymeleaf中，利用th:if和th:unless可以轻松实现条件渲染：

<p th:if="${user.isAdmin}">您是管理员。</p>
<p th:unless="${user.isAdmin}" th:text="${'欢迎,' + user.username}">默认欢迎语。</p>

最佳实践

使用Thymeleaf的标准命名惯例，增加代码可读性。
利用Thymeleaf的表达式对象(#arrays, #messages, etc.)进行高效的数据处理。
避免在模板中放置过于复杂的逻辑，保持模板的“清洁”。

典型生态项目

Thymeleaf生态系统丰富，提供了许多插件和整合方案，例如：

Thymeleaf Extras Tiles2 - 提供Apache Tiles 2.x的集成，便于复杂的页面结构管理。
- GitHub
Thymeleaf Interactive Tutorial - 互动教程帮助开发者快速学习Thymeleaf。
- GitHub
Thymeleaf Eclipse Plugin - 专为Eclipse IDE设计的Thymeleaf集成插件，提升开发体验。
- GitHub

这些生态项目进一步强化了Thymeleaf在不同场景下的适用性和灵活性，使开发者能够更便捷地利用Thymeleaf进行高效的Web应用开发。

thymeleaf

Thymeleaf is a modern server-side Java template engine for both web and standalone environments.

项目地址：https://gitcode.com/gh_mirrors/th/thymeleaf

登录后查看全文

项目优选

收起

kernel

deepin linux kernel

docs

OpenHarmony documentation | OpenHarmony开发者文档

openEuler内核是openEuler操作系统的核心，既是系统性能与稳定性的基石，也是连接处理器、设备与服务的桥梁。

336

178

ops-math

本项目是CANN提供的数学类基础计算算子库，实现网络在NPU上加速计算。

Ascend Extension for PyTorch

Nop Platform 2.0是基于可逆计算理论实现的采用面向语言编程范式的新一代低代码开发平台，包含基于全新原理从零开始研发的GraphQL引擎、ORM引擎、工作流引擎、报表引擎、规则引擎、批处理引引擎等完整设计。nop-entropy是它的后端部分，采用java语言实现，可选择集成Spring框架或者Quarkus框架。中小企业可以免费商用

Java

agent-studio

openJiuwen agent-studio提供零码、低码可视化开发和工作流编排，模型、知识库、插件等各资源管理能力

本仓将收集和展示高质量的仓颉示例代码，欢迎大家投稿，让全世界看到您的妙趣设计，也让更多人通过您的编码理解和喜爱仓颉语言。