如何修复HTML中Thymeleaf语法错误？IDEA报错但程序可正常运行
2026-5-13
解决IntelliJ IDEA中Thymeleaf语法错误提示但程序正常运行的问题
我之前也碰到过一模一样的情况——IDEA里Thymeleaf代码飘红报语法错误，但程序实际运行完全正常，这大概率是IDE的配置或者缓存问题，给你几个靠谱的解决办法：
先看你提到的错误截图：
你的代码如下：
<!DOCTYPE html> <html lang="zh-cmn-Hans" xmlns:th="http://www.thymeleaf.org"> <head> <meta http-equiv="Content-Type" content="text/html" charset="UTF-8"> <title>Title</title> </head> <body> <p th:text="${name}">name</p> <p th:text="'Hello! ' + ${name} + '!'">hello world</p> <p th:text="|Hello! ${name}!|">hello world</p> </body> </html>
具体解决步骤
确认Thymeleaf插件已安装并启用
打开IDEA的File → Settings → Plugins，搜索「Thymeleaf」，确保插件处于启用状态。如果未安装，点击「Install」按钮安装后重启IDE，插件会自动识别Thymeleaf语法。配置IDE的Thymeleaf支持
进入File → Settings → Languages & Frameworks → Template Languages → Thymeleaf，首先勾选Enable Thymeleaf support，然后确认配置的Thymeleaf版本与项目依赖的版本一致（比如你用的是3.x版本就选择对应选项），这样IDE就能正确解析你的Thymeleaf语法了。清除IDEA缓存并重启
IDE缓存异常会导致假报错，操作路径是File → Invalidate Caches...，在弹出窗口中选择Invalidate and Restart，等待IDE重启并重新加载项目，多数情况下飘红提示会消失。重新确认命名空间配置
你的代码中已经正确添加了xmlns:th="http://www.thymeleaf.org"命名空间，但如果IDE仍未识别，可以尝试先删除该行再重新输入，或者在命名空间上右键选择「Assign to namespace」指定为Thymeleaf。
内容的提问来源于stack exchange，提问作者oo0oo
