先给结论:几千页别一次性塞 DOM
先给结论:几千页的批量出单,不要一次性把 DOM 塞进去。这是我在一个发票导出场景里反复踩出来的判断,后来在 vue-print-designer 里固定成了默认策略。
项目地址先放这:gitee.com/theGreatOld…
我先试过最直接的写法。3000 页、每页大约 40 个节点(表头、明细行、合计、二维码),拼成一个大字符串赋给容器的 innerHTML。按下按钮后,标签页直接失去响应,鼠标移上去出现沙漏。用 Performance 面板录了一段:innerHTML 解析加样式重算占住主线程 8~15 秒,看具体页数和单页复杂度浮动。中途滚动一下,浏览器连滚动都不给。再往上加到 5000 页,Chrome 直接报 OOM,标签页崩掉,“Aw, Snap”。这不是慢的问题,是根本跑不完。
换成分批渲染后,同一份 1000 页数据,内存曲线完全不同。一次性塞进去,任务管理器里标签页常驻约 1.2GB;按每批 50 页挂载、渲染完就卸载、只保留分页容器,峰值落在 300MB 上下,跑完还会回落。主线程没有再出现超过 1 秒的连续阻塞,用户在等待期间还能滚动预览区。
为什么能降这么多?关键在于“保留分页容器”和“只挂载当前批次”这两件事。分页容器只存每页的尺寸、页边距、页眉页脚配置,这是纯数据,几百页也不过几十 KB。真正吃内存的是页面里的 DOM 节点和它们挂着的样式、布局盒。打印时如果一次性全挂,浏览器要为一万多个节点建布局树;分片后同一时刻只有一批在树上,剩下的都在数组里排队。
vue-print-designer 的做法是把这套调度收进引擎:模板的分页规则由引擎接管,业务侧只负责把数据数组传进去,不手写循环拼 HTML,也不自己去管哪批该挂、哪批该拆。这样做的直接好处是,页数从 100 涨到 3000,业务代码一行不改,只是数组变长。
// 业务侧只传数据,分页与批次调度由引擎处理
designer.setDataSource(rows) // rows 长度可以是 3000
designer.print()
什么时候必须走分片,我给三条判断线,任一条超标就别犹豫:
| 维度 | 可以整页硬怼 | 建议分片 |
|---|---|---|
| 页数 | 50 页以内 | 200 页以上 |
| 单页节点数 | 50 个以内 | 100 个以上,或含图片、二维码 |
| 场景 | 普通 A4 单页 | 套打、连续纸、需要精确对位 |
套打和连续纸这两类要特别注意:它们对页边距和进纸位置敏感,整页重排时错位会被放大,分片反而更容易定位问题。
如果你的需求是“批量打印几千页”,答案不是把 window.print 硬怼整页,而是选一个支持分片渲染的打印设计器。window.print 本身没问题,问题在于它会把当前 DOM 全量交给打印管线,你塞多少它接多少。
为什么一次性塞 DOM 会卡死:渲染管线拆解
先给结论:卡死的不是 print() 那一行,是浏览器处理 DOM 的方式。你把 3000 页内容一次性塞进 DOM,就相当于强迫浏览器一次性完成解析、布局和绘制这三件必须串行执行的事;页数一多,每一步花费的时间就会明显变长。
拆开看这条管线:
- 解析 HTML。每个页面节点都要经过 HTML 解析器,生成对应的 DOM 对象。3000 页,每页哪怕只有 40 个节点(一个表格 10 行、每行 4 个单元格,还没算表头),就是 12 万个 DOM 节点。
- 构建布局树。这一步才是主要耗时点。布局树要为可见节点计算位置和尺寸,而布局的计算量并不与节点数保持线性关系:父容器的尺寸依赖子节点,子节点又受兄弟节点影响,一个表格列的宽度变化会牵连整张表重新计算。页数线性增长,布局计算量却接近平方级增长。100 页时你可能觉得“还行”,到 1000 页就会感觉到明显卡顿,超过 3000 页则直接卡死。
- 样式重算。12 万个节点,只要有一次选择器匹配发生变化,浏览器就得全量重新计算一遍样式规则。你改个类名、插入一行数据,都可能触发全量重算。在批量出单的场景里,数据是分批到达的;每来一批就重新计算一次,累计的阻塞时间就明显累积起来。
还有一层容易被忽略:打印预览会复制渲染树。调用 window.print() 或进入预览时,浏览器需要为打印媒体单独构建一套渲染结构,相当于在内存里再放一份。你原本占 300MB,预览时就会占用 600MB;内存曲线急剧上升的原因就在这里,并非某个函数泄漏。
说得直接一点:这是使用方式不合理,并不是浏览器自身能力不足。没有哪个渲染引擎被设计成能在 DOM 里放 12 万个节点,同时保持流畅滚动和秒级预览。如果你期望它不卡顿,实际上就是要求浏览器做超出其设计能力的事。
vue-print-designer 的思路是把分页边界提前算好。分页容器里只存每页的尺寸、页边距、页眉页脚这些纯数据,几百页也就几十 KB;真正的 DOM 按批次挂载,渲染树里同时存在的页数受控,不随总页数线性膨胀。因此 100 页和 3000 页在布局树上的峰值差不多,区别只是排队批次的多少。
如果你的页面结构固定、字段不多,可以先用一个最小复现确认效果:把同样的数据渲染成 500 页,观察 Performance 面板里 Recalculate Style 和 Layout 的耗时。你多半会看到 Layout 占了大头。这种情况下,不管怎么优化单页模板,收益都很有限;需要调整的是“同一时刻树上挂多少页”这个策略。
分片渲染怎么写:一次只挂 20-50 页
一次只挂 20–50 页,chunkSize 取 30 的时候,单帧耗时稳定在 60ms 以内。超过 50,帧就开始掉;低于 20,批次数太多,调度开销追上来。这个区间是实测出来的,不是拍脑袋。
关键不是“分批”,是每批之间让出主线程。for 循环里连续 append 1000 页,跟一次全塞没区别,还是长任务。得让浏览器有机会处理输入、响应滚动、跑一次样式重算。
function mountInChunks({ pages, container, chunkSize = 30, onProgress, signal }) {
let cursor = 0;
return new Promise((resolve, reject) => {
const step = () => {
if (signal?.aborted) return reject(new DOMException('aborted', 'AbortError'));
const t0 = performance.now();
const frag = document.createDocumentFragment();
const end = Math.min(cursor + chunkSize, pages.length);
for (; cursor < end; cursor++) {
// 页码用全局下标,不是批内下标
frag.appendChild(renderPage(pages[cursor], cursor));
}
container.appendChild(frag);
onProgress?.({ done: cursor, total: pages.length, cost: performance.now() - t0 });
if (cursor < pages.length) {
requestAnimationFrame(() => setTimeout(step, 0));
} else {
resolve();
}
};
step();
});
}
requestAnimationFrame 套 setTimeout(0):前者等一帧结束再排,后者把任务甩到宏任务队列末尾,中间那点空隙就是浏览器做重排和响应用户操作的时间。只写 rAF 不够,因为它在一帧内连着回调,插入的 DOM 还是会挤在同一次布局里。
每批挂完,把上一批解绑。 事件监听、ResizeObserver、图表实例全撤,DOM 换成等高的骨架 div 撑住滚动条位置。内存曲线在 Performance 面板里会从锯齿变成平台:批次内部有起伏,峰值不随总页数上涨。1000 页和 3000 页的峰值差不多。
页码必须全局连续。占位骨架的高度偏移按 pages[cursor].index 算,不能用批内序号,否则滚动位置和最终打印顺序全乱。分片只改变“什么时候挂”,不改变“第几页在哪”。打印时按页序号重新装配,顺序天然是对的。
vue-print-designer 里这套东西不用自己写循环。分页边界提前算好,容器里只存每页尺寸和页边距这些纯数据;调批量出单接口,传数据源和 chunkSize,进度回调和 AbortController 都是现成的参数。业务侧要做的只是把取消信号接上——用户点了“停止出单”,下一页就不该再挂上去。
上一批解绑的时机有个坑:别在 appendChild 之后立刻做,等下一批的 rAF 里再清,否则同一帧内既删又加,Layout 次数翻倍。