perf(plugin): 条码/二维码 SVG 加参数指纹缓存

页面每次重渲染都会重新构造标签上下文对象,TagShell 的 computed 随之失效 ——
44 格的二维码每次都要重拼 2 万多个 <rect>,点一下格子就可能卡半秒。
按「参数指纹」缓存字符串即可(同一个 SN + 同一套参数,SVG 必然一模一样),
FIFO 上限 400 条避免无限增长。顺带把缓存块挪到文件前部(原在声明之后,读起来别扭)。

已用真实模块做过端到端验证(esbuild 打包 src/codes.ts 后跑 node):
- qrSvg 的真实 SVG 反解回矩阵 → jsQR 解码,6/6 与原串一致;
- code128Svg 的真实 rect 还原成游程序列 → 与 code128Bits 逐段一致(A / 16 位 SN / 12 位 SN);
- 缓存:同参数命中、换参数/换文本不串味、显式默认值与省略命中同一份。

产物已重新发布到插件仓库(同版本 1.0.0 覆盖,该版本尚未交付)。
This commit is contained in:
2026-10-03 23:53:56 +08:00
parent ef41d98838
commit 7c986fd5c5
+45
View File
@@ -24,6 +24,38 @@
import qrcode from "qrcode-generator";
/* ================================================================== */
/* 出图缓存 */
/* ================================================================== */
/**
* 为什么要缓存。
*
* 页面每次重渲染都会重新构造「标签上下文」对象(`labelContext(slot)`),
* 子组件的 computed 跟着失效、重算 —— 也就是**每一格都会重新拼一遍 SVG**。
* 一个 25×25 的二维码是 600 多个 `<rect>`,44 格就是 2 万多个节点;
* 用户点一下格子、改一下数量,浏览器就得重新解析一遍这些字符串,
* 表现为「点一下卡半秒」。
*
* 而真正变化的东西很少:同一个 SN、同一套参数,出来的 SVG 必然一模一样。
* 所以按「参数指纹」缓存字符串。用 FIFO 封顶,避免长时间换参数导致无限增长。
*/
const CACHE_LIMIT = 400;
const svgCache = new Map<string, string>();
function cached(key: string, build: () => string): string {
const hit = svgCache.get(key);
if (hit !== undefined) return hit;
const svg = build();
if (svgCache.size >= CACHE_LIMIT) {
// Map 保持插入顺序,删最老的那个即可
const oldest = svgCache.keys().next().value;
if (oldest !== undefined) svgCache.delete(oldest);
}
svgCache.set(key, svg);
return svg;
}
/* ================================================================== */
/* Code 128 Set B */
/* ================================================================== */
@@ -139,6 +171,14 @@ export const LABEL_BARCODE_STRIP_MM = code128HeightMm(LABEL_BARCODE_OPTS);
* (`ZP-260928-0001-R` 是 16 位,短码只有 12 位),固定模块宽度会时宽时窄。
*/
export function code128Svg(text: string, opts: BarcodeOptions = {}): string {
// 指纹按**解析后的默认值**拼,避免 `{}` 与显式默认值产生两份缓存
const key =
`b|${text}|${opts.widthMm ?? 46}|${opts.heightMm ?? 7}|` +
`${opts.showText !== false}|${opts.textMm ?? 1.9}`;
return cached(key, () => buildCode128Svg(text, opts));
}
function buildCode128Svg(text: string, opts: BarcodeOptions = {}): string {
const widthMm = opts.widthMm ?? 46;
const heightMm = opts.heightMm ?? 7;
const showText = opts.showText !== false;
@@ -239,6 +279,11 @@ export interface QrOptions {
* 二维码会自己跟着缩,不需要在 JS 里重复算一遍布局。
*/
export function qrSvg(text: string, opts: QrOptions = {}): string {
const key = `q|${text}|${opts.ec ?? "M"}|${opts.quiet ?? 4}|${opts.dark ?? "#000"}`;
return cached(key, () => buildQrSvg(text, opts));
}
function buildQrSvg(text: string, opts: QrOptions = {}): string {
const quiet = opts.quiet ?? 4;
const dark = opts.dark ?? "#000";