行，但仅适用于完全静态页面；index.html放入static目录后可直接访问，但无后端数据渲染、不经过Spring Security校验，且Thymeleaf语法不会被解析。
直接放 index.html 到 static 目录行不行？
行，但只适用于完全静态的页面——没有后端数据、不校验登录态、不走 Spring Security 过滤链。把 index.html 放进 src/main/resources/static/，启动后访问 /index.html 就能立刻看到内容。
常见错误现象：页面里写了 th:text="${user.name}"，结果原样输出没渲染；或者用 AJAX 调 /api/user 却返回 403，因为请求绕过了 Spring Security，没带 cookie 或 token。
- 所有 JS/CSS/图片必须按实际路径组织，比如 CSS 在
static/css/app.css，HTML 里就得写<link href="./css/app.css"> - 相对路径的 AJAX 请求（如
fetch("/api/user")）默认发到当前域名根路径，后端若没配 CORS 或反向代理，会跨域失败 - 无法拦截未登录用户访问该 HTML——Spring Security 对
/static/**默认放行
Thymeleaf 模板必须放在 templates 目录吗？
是，且路径和扩展名必须严格匹配 Spring Boot 的约定：模板文件得放在 src/main/resources/templates/，扩展名是 .html，控制器返回字符串（如 "user/list"）时，框架自动去这个目录下找 user/list.html。
容易踩的坑：忘了加依赖或配错路径。没引入 spring-boot-starter-thymeleaf，模板里的 th:* 标签会被当普通 HTML 属性原样输出；配了 spring.thymeleaf.prefix=classpath:/views/ 却没改目录，就会 404。
立即学习“前端免费学习笔记（深入）”；
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
-
pom.xml中必须有spring-boot-starter-thymeleaf，否则 Model 数据传不进去 -
application.yml里至少保留默认配置：spring.thymeleaf.suffix: .html，spring.thymeleaf.encoding: UTF-8 - 自闭合标签如
<img src="" />在 Thymeleaf 默认 HTML 模式下会报TemplateInputException，得写成<img src="">或启用 LEGACYHTML5 模式（需额外加 nekohtml 依赖）
前后端分离时，前端构建出的 dist/ 怎么扔进 Spring Boot？
把整个 dist/ 目录内容复制到 src/main/resources/static/ 下即可，但有两个硬性前提：入口文件必须是 index.html，且前端路由不能用 hash 模式（#/user）以外的模式。
如果用了 history 模式（如 /user/123），刷新页面会 404——因为 Spring Boot 静态资源处理器只认真实存在的文件，不认识前端虚拟路由。
- 必须加兜底路由：
@GetMapping("/**")返回"forward:/index.html"，让所有未匹配的请求都落到前端路由入口 -
dist/里的 JS/CSS 路径要和实际部署结构一致，比如构建时设了publicPath: "/app/"，那index.html里就得引用/app/js/app.xxx.js - 别把
dist/index.html直接塞进templates目录——Thymeleaf 会尝试解析它，而它不含 Thymeleaf 语法，纯属浪费
为什么不用 JSP？
Spring Boot 官方不支持 JSP，内嵌 Tomcat 启动时根本不会扫描 /WEB-INF/ 下的 JSP 文件。即使强行打包成 war 部署到外部 Tomcat，也要额外加 tomcat-jasper 依赖、配 web.xml、处理 classloader 问题，维护成本远高于 Thymeleaf 或前后端分离。
真正需要服务端渲染又排斥 Thymeleaf 的场景极少，FreeMarker 或 Velocity 是更现实的替代选项，但它们同样要配依赖、放模板目录、写 Controller 返回逻辑——没本质简化。
复杂点在于：选哪种方案不取决于“哪个更高级”，而取决于“谁承担哪块职责”。静态页就放 static；要注入数据+权限控制，就上 Thymeleaf；交互密集+多人协作，就切前后端分离。混用反而让路径、缓存、部署全乱套。
