直接操作 minify-html 的 AST 易删错标签，因其仅为压缩设计的轻量中间表示，不保留语义约束与上下文错误恢复；安全剔除需结合 DOM 语义与渲染影响评估，而非仅看节点内容。
为什么直接操作 minify-html 的 AST 节点容易删错标签
minify-html 的 AST 并非通用语法树，而是为压缩服务的轻量中间表示：它不保留原始 HTML 中的语义约束（比如 table 必须包含 tbody 或允许省略），也不记录解析时的上下文错误恢复行为。直接遍历 ast.children 并删除“看起来冗余”的节点（如空 div、无属性的 span），会忽略以下事实：
- 某些空标签在 CSS 中被用作占位或伪元素钩子（如 <div class="spacer"></div>）
- 自闭合标签（img、br）与可选结束标签（p、li）在 AST 中节点类型不同，但删除逻辑若未区分，会导致序列化后结构损坏
- 注释节点（Comment）若被无差别移除，可能误删构建工具标记（如 <!-- inject:css -->）
真正安全的剔除，必须结合 DOM 语义规则 + 实际渲染影响评估，而非仅看 AST 节点是否存在子内容。
如何用 minify-html-onepass 实现单遍冗余剔除
minify-html-onepass 的核心价值不是“更细粒度控制 AST”，而是跳过完整 AST 构建阶段，在解析流中实时决策。它通过预注册的“压缩钩子”（hook）介入 token 流，例如：
- 遇到开始标签时，检查是否属于已知无作用容器（如 div 且无 class/id/style/事件属性，且后续只跟纯文本或另一个同类 div）
- 遇到结束标签时，回溯最近未闭合的开始标签，判断是否可折叠（如连续 div><div> 嵌套且无样式隔离需求）
启用方式很简单：
- 替换依赖：
yarn add minify-html-onepass（非minify-html） - 调用时传入
onepass: true选项，而非手动操作 AST - 禁用
removeComments若需保留构建注释；启用collapseWhitespace配合removeEmptyAttributes才能触发容器折叠逻辑
哪些标签绝对不能无条件剔除
即使 AST 显示为空或无属性，以下标签在多数前端框架或 CSS 体系中承担隐式语义，强行删除会破坏布局或交互： -slot：Web Components 中的内容分发锚点，空 <slot></slot> 是合法且必需的
- template：浏览器不渲染但 JS 可克隆，AST 中常为空，但删除等于移除运行时模板
- script 和 style：即使内容为空字符串，其标签存在本身可能被 JS 查询（document.querySelectorAll('script')）
- svg 子元素如 defs、symbol：不渲染但被引用，AST 中常无子节点，但不可删
检测时应优先识别标签名 + 父级上下文（如 template 下的 svg），而非仅依赖 node.children.length === 0。
Article To Html
下载
文章转信息图。将文章/笔记转化为手机可读的 HTML 信息图，自动匹配视觉风格。触发场景：文章转图、笔记转图、信息图、转小红书图、做张图、可视化这篇文章、文生图。
性能临界点：AST 深度超过 12 层时的优化取舍
当 HTML 文档嵌套深度 ≥ 12（常见于复杂表单或组件化渲染输出），minify-html 的默认递归遍历会触发 V8 引擎的栈深度限制警告，而 minify-html-onepass 因采用迭代状态机，不受此限。但此时需权衡：
- 开启 removeRedundantAttributes 会显著增加属性键值比对开销（尤其含大量 data- 属性时）
- 启用 minifyCSS 或 minifyJS 会延长单次处理时间，建议拆分为独立 pipeline 阶段
- 对于 SSR 输出的 HTML，应在生成阶段就避免深层嵌套（如用 CSS Grid 替代多层 div 包裹），比压缩阶段修复更高效
真正卡顿往往不出现在 AST 遍历，而出现在序列化阶段——c14n_serialise_ast 对超深节点需反复拼接字符串，此时应考虑分块压缩或降级为流式写入。
立即学习“前端免费学习笔记（深入）”；
