Thymeleaf模板渲染失败主因是数据未传入、键名错误或转义问题；Layui templet中漏写等号导致HTML被转义。

模板渲染失败，90%的情况不是引擎坏了，而是变量根本没传进去、传错了名、或者被转义了——先确认数据是否真的到达了模板，再查语法。

Thymeleaf中${user.name}为空？先看model.addAttribute()键名对不对

Spring Boot里model.addAttribute("user", userModel)和${user.name}才能匹配；如果写成model.addAttribute("person", userModel)，那${user.name}永远是空。大小写也敏感：userModel.getUsername()返回值有效，但${userModel.Username}会报错或为空，因为Thymeleaf不识别Username这个属性名。

• 临时硬编码验证：在Controller里写model.addAttribute("user", "test")，再刷新页面看是否显示test
• 检查UserModel是否真被注入：参数UserModel userModel不是自动绑定的登录用户，而是new出来的空对象，要用@AuthenticationPrincipal或SecurityContextHolder取真实用户
• 用浏览器“查看页面源代码”，搜索user关键字，确认th:*指令是否被正确解析（未解析说明Thymeleaf未生效，可能是@Controller写成了@RestController）

Layui表格templet里被当文本显示？记得用{{= d.xxx}}而不是{{ d.xxx}}

Layui默认对templet内容做HTML转义，{{ d.status }}输出的是字符串active，而{{= d.status }}才真正渲染为加粗文本。漏掉等号是高频错误。

• 函数模板写法：templet: '
  {{= d.status }}
  '
• 脚本模板写法：<script type="text/html" id="statusTpl">{{= d.status }}</script>，再配templet: '#statusTpl'
• 如果d.status本身含引号或，仍可能破坏DOM结构，建议服务端预处理或前端用DOMPurify.sanitize()兜底

浏览器Elements里看到的DOM和你写的HTML不一致？别信源码，信Elements面板

浏览器会主动修复非法嵌套，比如

text

使用华数设计生成高保真HTML原型、演示文稿、动画和设计评审

使用经过文档化的设计技能，从真实的品牌或项目背景中生成HTML原生原型、幻灯片、动态演示、可视化图表和评审流程。

下载

会被重排成

text

。这意味着你写的模板逻辑可能早被DOM重建覆盖了。

• 、
  、内部不允许直接塞
  ，否则整段结构可能被拆散

  服务端模板（如Jinja2）里{{ content | safe }}输出的HTML若含未闭合标签，也会触发浏览器修复，导致后续DOM错乱

  打开“查看页面源代码”对比Elements面板，若两者差异大，问题大概率出在服务端输出的HTML本身有语法错误

  本地双击打开HTML时图片404？路径解析规则和服务器完全不同

  本地文件协议下./static/css/app.css按当前HTML所在目录解析；而Spring Boot、Flask等服务端把/static/映射到类路径或指定目录，./和/行为不一致。

  • 开发时统一用绝对路径：/static/css/app.css（服务端可配spring.web.resources.static-locations）
  • 避免在模板里拼接路径，改用服务端注入的上下文路径变量，如Thymeleaf中th:src="@{/static/img/logo.png}"
  • FreeMarker中用再拼接，比硬编码更可靠

  最常被忽略的一点：模板引擎不会告诉你“变量不存在”，它只会静默输出空字符串或原始占位符。所以看到空白或{{user.name}}原样显示，第一反应不该是“引擎配置错了”，而是“这个变量压根没传进来”。

前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！