###
Spring Cloud 中
Thymeleaf 配置与静态资源打包
在
Spring Cloud 项目中，正确
配置 Thymeleaf 模板引擎并确保静态资源能够被打包是一项常见的需求。以下是详细的说明：
#### 1. 添加依赖项
为了支持
Thymeleaf 和静态资源的处理，在 `pom.xml` 文件中需引入必要的 Maven 依赖项。
```xml
<dependencies>
<!--
Spring Boot Web Starter -->
<dependency>
<groupId>org.
springframework.boot</groupId>
<artifactId>
spring-boot-starter-web</artifactId>
</dependency>
<!--
Thymeleaf Starter -->
<dependency>
<groupId>org.
springframework.boot</groupId>
<artifactId>
spring-boot-starter-
thymeleaf</artifactId>
</dependency>
<!-- Static Resource Support (Optional, usually included by default) -->
<dependency>
<groupId>org.webjars</groupId>
<artifactId>webjars-locator-core</artifactId>
</dependency>
</dependencies>
```
以上代码片段展示了如何通过 Maven 引入
Thymeleaf 及其相关组件[^3]。
---
#### 2.
配置 Thymeleaf 参数
在项目的 `application.properties` 或 `application.yml` 文件中，可以自定义
Thymeleaf 的行为参数。例如缓存设置、编码方式等。
##### 使用 application.properties 进行
配置：
```properties
# 开发环境建议关闭缓存以便实时查看效果
spring.
thymeleaf.cache=false
# 设置字符集为 UTF-8
spring.
thymeleaf.encoding=UTF-8
# 定义模板前缀和后缀路径
spring.
thymeleaf.prefix=classpath:/templates/
spring.
thymeleaf.suffix=.html
```
##### 使用 application.yml 进行
配置：
```yaml
spring:
thymeleaf:
cache: false
encoding: UTF-8
prefix: classpath:/templates/
suffix: .html
```
这些
配置确保了
Thymeleaf 能够正常加载 HTML 模板文件，并适配不同的运行环境[^4]。
---
#### 3. 处理静态资源
Spring Boot 默认会自动扫描某些目录下的静态资源文件（如 CSS、JavaScript、图片等），并将它们映射到特定 URL 下。默认情况下，以下目录会被识别为静态资源根目录：
- `/src/main/resources/static/`
- `/src/main/resources/public/`
- `/src/main/resources/META-INF/resources/`
如果需要额外指定其他静态资源路径，则可以在 `application.properties` 或 `application.yml` 中扩展
配置。
##### 自定义静态资源路径：
```properties
spring.resources.static-locations=classpath:/static/,classpath:/custom-resources/
```
或者使用 YAML 格式：
```yaml
spring:
resources:
static-locations: classpath:/static/,classpath:/custom-resources/
```
这样就可以将多个目录中的静态资源统一管理起来[^5]。
---
#### 4. 打包静态资源
当使用 Maven 构建工具时，默认会将位于上述静态资源目录内的文件复制至最终生成的 JAR/WAR 包中。因此无需特别操作即可完成静态资源的打包过程。
不过需要注意的是，如果存在复杂的前端工程结构（例如 Vue.js 或 React 应用程序嵌套于 Java 后端之中），则可能需要借助构建工具（如 Webpack）先编译前端代码再将其产物放入对应的静态资源目录下。
---
#### 5. 测试功能
创建一个简单的控制器来测试
Thymeleaf 渲染以及静态资源
配置是否生效。
```java
package com.example.demo.controller;
import org.
springframework.stereotype.Controller;
import org.
springframework.ui.Model;
import org.
springframework.web.bind.annotation.GetMapping;
@Controller
public class IndexController {
@GetMapping("/")
public String index(Model model) {
model.addAttribute("message", "Welcome to the
Spring Cloud with
Thymeleaf!");
return "index";
}
}
```
同时准备一份名为 `index.html` 的模板文件放置于 `resources/templates/` 目录下：
```html
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml" xmlns:th="https://www.
thymeleaf.org">
<head>
<title>Home Page</title>
<link rel="stylesheet" type="text/css" href="/css/style.css"/>
</head>
<body>
<h1 th:text="${message}">Default Message</h1>
<p>This is a paragraph.</p>
<script src="/js/app.js"></script>
</body>
</html>
```
最后确认样式表 (`style.css`) 和脚本文件 (`app.js`) 已经存在于 `resources/static/css/` 和 `resources/static/js/` 子目录里[^6]。
---
### 总结
按照上述
方法可顺利完成
Spring Cloud 项目中关于
Thymeleaf 模板引擎及其关联静态资源的相关
配置工作。整个流程涵盖了从基础依赖导入直至实际应用层面的具体实现细节。
本文介绍如何在Spring框架中配置Thymeleaf作为HTML5模板引擎，并提供详细的配置步骤，包括所需依赖Jar包及SpringMVC配置文件的具体设置。
扫一扫
2092
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
