用 Playwright 把尺码表、参数表批量渲染成详情页图片:30 张约 3.2 秒,和四个字体与截断的坑

1 阅读6分钟

项目地址:github.com/microsoft/p… 信息核实时间:2026-11-13(Asia/Shanghai)。GitHub 仓库信息:100014 star,许可证 Apache-2.0,未归档,最近推送 2026-11-13 08:54(北京时间)。npm 上 playwright 最新版 1.65.0,发布于 2026-11-06 02:28(北京时间),对应浏览器为 chromium v1254(Chrome for Testing 158.0.8127.18)。本文代码和数据均为本人在 Debian 13、Node 24.22.1、npm 11.21.1、8 核 Xeon(无 GPU)上实际运行的结果。 本文为原创整理,不涉及任何商业推广。

一、场景:详情页里最容易出错的那几张图

电商详情页里有一类图几乎全是文字:尺码表、参数表、规格对比表。它们不需要什么设计感,但数字一个都不能错。设计师在 PS 里一张张改,改到第十个 SKU 很容易漏掉一格;而运营手里其实早就有一份准确的规格数据,在后台、在 Excel 里。

既然数据是结构化的,表格又是网页最擅长排的东西,那就用 HTML + CSS 写模板,交给无头浏览器截图。Playwright 本来是做端到端测试的,但它的元素截图、设备像素比、字体渲染都很适合干这件事:前端同学写的样式,就是最终出图的样子。

二、整体思路

  1. 规格数据放在 JSON 里,每个商品一条:标题、SKU 编号、表头、行数据、备注;
  2. 模板函数把一条数据拼成 HTML 字符串,宽度固定 750 CSS 像素;
  3. 启动一次浏览器、开一个页面,deviceScaleFactor: 2,逐条 setContent 后对 .card 元素截图,输出 1500 像素宽的 PNG;
  4. 截图前做一道检查:有没有被截断的单元格。

三、安装

npm i playwright
npx playwright install chromium

第二步会把对应版本的 Chromium 下载到 ~/.cache/ms-playwright。Linux 服务器上如果缺系统依赖,可以用 npx playwright install --with-deps chromium(需要 root)。

四、代码

数据 specs.json(节选):

[
 {"sku":"TS-01","title":"纯棉圆领T恤 尺码表","note":"平铺测量,误差 1–2cm 属正常",
  "head":["尺码","衣长","胸围","肩宽","袖长","建议身高"],
  "rows":[["S","66","96","42","19","155–165"],["M","69","100","44","20","165–172"], ...]},
 ...
]

模板 tpl.mjs:

export const css = (font) => `
  ${font}
  *{box-sizing:border-box;margin:0}
  body{width:750px;font-family:'Noto Sans CJK SC',sans-serif;background:transparent}
  .card{width:750px;padding:48px 40px;background:#fff}
  h1{font-size:40px;color:#222;margin-bottom:8px}
  .sku{font-size:20px;color:#999;margin-bottom:28px}
  table{width:100%;border-collapse:collapse;table-layout:fixed}
  th{background:#2f6f8f;color:#fff;font-size:24px;padding:14px 6px}
  td{font-size:24px;color:#333;text-align:center;padding:14px 6px;border-bottom:1px solid #e5e5e5;white-space:nowrap;overflow:hidden}
  tr:nth-child(even) td{background:#f6f9fb}
  .note{margin-top:22px;font-size:20px;color:#888}`;
const esc = s => String(s).replace(/[&<>]/g, c => ({'&':'&amp;','<':'&lt;','>':'&gt;'}[c]));
export const html = (s, font='') => `<!doctype html><meta charset="utf-8"><style>${css(font)}</style>
<div class="card"><h1>${esc(s.title)}</h1><div class="sku">${esc(s.sku)}</div>
<table><tr>${s.head.map(h=>`<th>${esc(h)}</th>`).join('')}</tr>
${s.rows.map(r=>`<tr>${r.map(c=>`<td>${esc(c)}</td>`).join('')}</tr>`).join('')}</table>
<div class="note">${esc(s.note)}</div></div>`;

渲染 render.mjs:

// day35 掘金实测:Playwright 批量把参数/尺码数据渲染成详情页参数图
import { chromium } from 'playwright';
import { readFileSync } from 'node:fs';
import { html } from './tpl.mjs';
const specs = JSON.parse(readFileSync('specs.json', 'utf8'));
const browser = await chromium.launch();
const page = await browser.newPage({ viewport: { width: 750, height: 800 }, deviceScaleFactor: 2 });
const report = [];
const t0 = performance.now();
const N = Number(process.env.N || 1);
for (let k = 0; k < N; k++) for (const s of specs) {
  await page.setContent(html(s), { waitUntil: 'load' });
  await page.evaluate(() => document.fonts.ready);
  // 检查:被截断的单元格(scrollWidth > clientWidth)
  const overflow = await page.$$eval('td,th', els => els.filter(e => e.scrollWidth > e.clientWidth).map(e => e.textContent));
  const card = page.locator('.card');
  await card.screenshot({ path: `out/${s.sku}-${k}.png`, omitBackground: true });
  if (k === 0) report.push({ sku: s.sku, overflow });
}
const ms = performance.now() - t0;
console.log(JSON.stringify({ images: N * specs.length, ms: Math.round(ms), report }, null, 1));
await browser.close();

运行 node render.mjs 出 3 张;N=10 node render.mjs 把 3 条数据各重复 10 遍,用来测速。

五、我跑了一遍

Playwright 批量渲染效果

图注:Playwright 批量渲染的 3 张参数/尺码图(本地实测输出,作者截图)

输出:每张 1500 像素宽,高度随内容变化(1306、1178、1050 像素)。.card 自带白色背景,所以虽然写了 omitBackground,输出仍是不透明的;想要透明底,把 .card 的背景去掉即可。

速度:30 张串行,同一个页面复用,三次分别 3173、3180、3203 毫秒,平均一张约 0.1 秒。作为对照,每张图都重新启动一次浏览器,30 张两次都是约 6.26 秒,慢了将近一倍,所以批量时浏览器和页面要复用。

检查结果:保温杯那张表报出 2 个被截断的单元格,“通勤、随身包”和那句很长的适合场景。图上只看得到“通勤、随身”和“户外、健身房”,后半截被 overflow:hidden 吃掉了。如果没有这道检查,这张图会带着半句话上线。

六、四个坑

坑一:不写中文字体名,会用日文字形。 模板最早只写了 font-family: sans-serif。用 Chrome DevTools Protocol 的 CSS.getPlatformFontsForNode 查实际用到的字体,中文字符走的是 Noto Sans CJK JP。“直”“骨”“角”这几个字,日文字形和简体中文写法不一样,放大看很明显:

中文字体回退对照

图注:同样的文字:sans-serif 回退到日文字形(上)与显式指定 Noto Sans CJK SC(下)(本地实测截图)

我试过给 <html> 加 lang="zh-CN",在这台机器上回退结果没变,仍是 JP。最稳的办法是在 CSS 里显式写简体中文字体名,比如 'Noto Sans CJK SC',并且在部署镜像里装好这款字体。

坑二:setContent 之后,file:// 字体加载失败且不报错。 想用 @font-face 引用本地字体文件,src:url(file:///...) 在 setContent 出来的页面里加载失败:页面地址是 about:blank,document.fonts 里这个字体状态是 error,文字悄悄回退到系统字体,截图照样生成,不看字形发现不了。先 page.goto('file:///.../blank.html') 再 setContent,同样的字体就能加载成功。也可以起一个本地 HTTP 服务来提供字体文件,这个方案我没有测。

坑三:@font-face 引用 .ttc 只会用第一个字面。 Noto CJK 常见的是 .ttc 合集,一个文件里同时有 JP、KR、SC、TC、HK 几种字面。用 @font-face 引用这个 .ttc(在坑二的 file:// 页面里),字体状态是 loaded,但实际渲染用的是 Noto Sans CJK JP,也就是合集里的第一个字面。要用 @font-face,就找单独的 SC 版 OTF 文件;或者干脆用系统字体名。

坑四:nowrap + overflow:hidden 会安静地吃字。 表格单元格为了整齐通常不换行,长文字就被裁掉了,截图不会报错。我在截图前用 scrollWidth > clientWidth 找出所有被截断的单元格并打印出来,实际批量时可以直接让这条数据失败,交给人改文案或调列宽。

七、局限和要注意的

  • 它只负责“排对”:数据错了,图也会错。规格数据要从后台或唯一的表格导出,不要人工再抄一遍。
  • 字体授权:出图的字体会出现在商品详情里,属于商用,字体的授权范围要确认。Noto CJK 是 SIL Open Font License,其他字体以各自授权为准。
  • 平台尺寸:750 CSS 像素宽、2 倍图是我自己的设置,各平台对详情图的宽度、大小、格式要求以平台规则为准,可以改 viewport 和 deviceScaleFactor 适配。
  • 长表格:行数多的时候元素截图会很长,一些平台对单张详情图高度有限制,需要按行数拆成多张,或者截图后再切片。
  • 安装体积:我这台机器上 chromium-1254 目录 413MB、headless shell 283MB,放进 CI 或镜像要算上,并锁定 playwright 版本,避免浏览器版本变化导致渲染差异。

八、小结

尺码表、参数表这类详情页图片,本质是“数据 × 模板”,用 HTML 写模板、Playwright 截图,前端同学几十行代码就能批量出图,30 张三秒左右。真正要花心思的是检查:显式指定简体中文字体、别在 about:blank 里加载本地字体、别用 .ttc 做 @font-face、截图前查一遍截断的单元格。这几步做好,比人工改图更不容易错。