11.2 Thymeleaf解析级注释块

Thymeleaf 解析级注释块（Parser-level comment blocks）是一种仅在模板解析阶段被移除的注释语法，核心作用是：静态预览时显示注释内的内容（提升原型友好性），但 Thymeleaf 处理模板时会完全删除这些内容，不会出现在最终渲染结果中。

比如：

<!--/* 注释：解析时直接移除 */-->

解析级注释块的格式为 <!--/* 注释内容 */-->，解析级注释块中的代码在静态预览可见，但 Thymeleaf 处理时自动移除。

<!--/*-->
  <!-- 多行内容：静态预览可见，解析时完全移除 -->
  <div>you can see me only before Thymeleaf processes me!</div>
<!--*/-->

这在为包含大量 <tr> 的表格制作原型时会非常方便：

<table>
    <!-- 真实数据行：Thymeleaf 处理时遍历生成 -->
    <tr th:each="x : ${xs}">
        ...
    </tr>
    <!--/*-->
    <!-- 模拟行：静态预览可见，解析时完全移除 -->
    <tr>
        <td>模拟数据1</td>
    </tr>
    <tr>
        <td>模拟数据2</td>
    </tr>
    <!--*/-->
</table>

核心特征

特性	解析级注释块	标准 HTML 注释
静态预览（浏览器直接打开）	注释内内容可见（原型友好）	注释内内容不可见
Thymeleaf 解析阶段	完全移除，不参与后续处理	原样保留，不解析
最终渲染结果	无任何残留	注释及内容原样输出

关键说明

• 移除时机：解析级注释块在 Thymeleaf 解析模板的阶段就被移除，而非渲染阶段——意味着注释内的内容不会被解析、不会占用内存，对性能无影响；
• 内容无限制：注释内可包含任意 HTML 代码、Thymeleaf 语法（但这些语法不会被执行，因为整个块已被移除）；
• 语法注意：
  • 单行注释：<!--/* 注释文本 */-->（结尾的 */--> 不能拆分）；
  • 多行注释：必须以 <!--/*--> 开头，<!--*/--> 结尾，中间内容可任意换行。

对比示例：静态预览 vs 动态渲染

模板代码（静态预览）	Thymeleaf 处理后结果
可见真实行占位符 + 模拟行	仅可见 th:each 生成的真实行
表格结构完整，原型更逼真	无模拟行，数据准确

总结

1. 解析级注释块 <!--/* ... */--> 是 Thymeleaf 专属语法，静态预览时显示内容，解析时完全移除；
2. 核心价值：解决「静态原型需要模拟数据，动态渲染需要移除模拟数据」的矛盾，尤其适合表格、列表等需要多行为原型的场景；
3. 与标准 HTML 注释的核心区别：解析级注释不残留到最终结果，标准注释会原样输出。