Thymeleaf无法在CSS文件中解析表达式，动态主题切换必须通过HTML中<link th:href="@{...}">实现路径动态生成，如th:href="@{/css/themes/{theme}/main.css(theme=${currentTheme})}"，CSS内@import不支持服务端变量。
Thymeleaf 本身不支持在 .css 文件里动态解析表达式（比如 ${theme} 或 #{...}），所以「在 CSS 文件中动态引入 CSS」这个需求本质上无法直接实现。真正可行的，是在 HTML 模板中动态生成 <link> 标签的 href 属性值。
th:href="@{...}" 是唯一可靠的方式
静态资源路径必须通过 Thymeleaf 的 URL 表达式 @{...} 构造，否则 Spring Boot 的资源处理器无法识别上下文路径（如 /myapp）或版本哈希（如 /css/main.css?v=123）。直接写 href="/css/theme-dark.css" 在部署到子路径时会 404。
-
th:href="@{/css/themes/{theme}/main.css(theme=${currentTheme})}"—— 支持路径变量和参数拼接 -
th:href="@{/css/main.css(v=${@environment.getProperty('app.version')})}"—— 可注入配置项做缓存 busting - 避免混用：
href="/css/xxx.css" th:href="@{/css/xxx.css}"会导致浏览器加载两次（一次失败，一次成功）
主题切换不能靠 CSS @import 动态加载
CSS 文件内的 @import url(...) 是纯客户端行为，Thymeleaf 完全不处理它，也无法注入后端变量。例如：@import url("/css/themes/${theme}/base.css"); 会被浏览器原样发送请求，${theme} 不会被解析，最终 404。
- 所有主题 CSS 必须在 HTML 中显式声明为
<link th:href="@{...}"> - 若需运行时切换，得靠 JS + AJAX 加载新 link 标签，后端只提供主题列表接口，不参与 CSS 解析
- 服务端渲染阶段只能决定「初始加载哪一套」，无法让单个 CSS 文件内部分支逻辑
WebJars 和本地 static 资源路径要区分清楚
Spring Boot 默认把 classpath:/static/ 映射为根路径（如 /js/xxx.js），但 WebJars（如 Bootstrap）走的是 /webjars/... 路径。两者在 @{...} 中写法不同，写错就 404。
立即学习“前端免费学习笔记（深入）”；
- 本地 CSS：
th:href="@{/css/app.css}"→ 对应src/main/resources/static/css/app.css - WebJars CSS：
th:href="@{/webjars/bootstrap/5.3.3/css/bootstrap.min.css}"→ 依赖已声明且 JAR 存在 - 别写成
@{/static/css/app.css}：Spring Boot 默认不暴露/static/前缀，多加/static会导致路径错误
真正容易被忽略的点是：CSS 文件本身永远是静态文本，所有「动态」都必须落在 HTML 的 <link> 标签上，且必须用 th:href；任何试图在 CSS 内容里写 Thymeleaf 表达式的做法，都会被当作普通字符串忽略掉。
