模板解析慢的根源在于重复解析同一模板字符串，应提前编译为函数并缓存；htmlheadertextsplitter需显式配置headers_to_split_on；art-template多层继承中block名须全局唯一；非首屏内容应使用而非display:none。

模板解析慢，先看是不是在反复 parse 同一模板字符串

常见错误现象：render(template, data) 每次调用都传入原始字符串，导致 parse() 函数重复执行词法分析——哪怕模板完全没变。这对高频 SSR 场景（如新闻首页每秒数百请求）是严重浪费。

使用场景：Node.js + Express / Koa 中用 art-template、nunjucks 或自研轻量引擎做 SSR。

• 必须把模板字符串提前编译成函数，例如 art-template 的 template.compile() 返回可复用的 renderFn
• 避免在 request handler 内直接调用 template.render(str, data)，这隐式触发每次 parse
• 若用自研引擎，确保 parse(template) 结果被缓存，key 可用 template.slice(0, 100) + template.length 粗略去重
• 注意：带动态 include 的模板（如 {{include 'partial.art'}}）不能全量缓存，需按依赖树做细粒度缓存

HTMLHeaderTextSplitter 配置错误导致解析卡死或 OOM

错误现象：服务端渲染含长文档的页面时，CPU 拉满、响应超时，日志里出现 RangeError: Maximum call stack size exceeded 或进程被系统 OOM killer 杀掉。

根本原因不是模板本身大，而是 HTMLHeaderTextSplitter 默认只切 <h1></h1>，遇到含大量 <h2><h3></h3></h2> 的门户文档时，单块体积暴涨到 500KB+，后续向量化或渲染直接崩溃。

html-ppt-to-pdf

将使用 `

` 约定的 HTML 幻灯片转换为高保真、矢量文本 PDF（使用 Playwright + Chromium 原生 PDF 功能）。

下载

• 必须显式传入 headers_to_split_on=[("h1", "title"), ("h2", "section"), ("h3", "subsection")]
• 若文档含 <table> 或 <code><pre class="brush:php;toolbar:false;">&lt;code&gt;&lt;/code&gt;，换用 &lt;code&gt;HTMLSemanticPreservingSplitter&lt;/code&gt;，否则表格跨行、代码缩进会被截断 </pre> <li>调试时加 <code>return_each_element=True，方便定位哪一段 HTML 导致解析异常

art-template 多层继承中 block 覆盖引发内容丢失

现象：页面某区域（如侧边栏推荐位）在某些路径下完全空白，但单独访问子模板又正常；构建产物里发现多个 {{block 'content'}} 定义，但只有最内层生效。

本质是模板继承链中同名 block 被覆盖，而非叠加。比如 layout.art 定义了 {{block 'header-nav'}}，inner-layout.art 也定义同名 block，后者会彻底替换前者，中间层插入点失效。

• 所有 block 名必须全局唯一且语义化，例如 'main-hero'、'sidebar-recommend'，禁止泛用 'content' 或 'body'
• 项目根目录维护 blocks.json，列出所有 block 名及其用途，CI 阶段用脚本校验重复
• 继承层级建议 ≤ 3 层（layout → section → page），过深会导致编译缓存命中率骤降、调试困难

非首屏内容用 <template></template> 而不是 display: none

错误做法：把商品列表后 50 页、长图文下半截用 style="display: none" 包裹，以为“不显示=不消耗资源”。实际浏览器仍会解析、构建 DOM、计算 CSSOM，只是跳过绘制。

性能影响：对含上千节点的页面，display: none 区域仍拖慢首屏 FCP 达 300ms+，尤其在低端安卓机上明显卡顿。

• 改用原生 <template></template> 标签包裹非首屏 HTML 片段，它不参与 DOM 构建，内存占用趋近于零
• 配合 IntersectionObserver 在元素进入视口时再 template.content.cloneNode(true) 插入
• 注意：不要在 <template></template> 里写内联脚本，它不会执行；需手动绑定事件或调用初始化函数
模板解析不是越“智能”越快，而是越确定、越提前固化越稳。最容易被忽略的是：你以为在优化模板，其实瓶颈早就在 parse 阶段被反复执行了几十次——而你还在调 render() 的参数。

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