二维码与条形码速查表

实战片段

要点：① 纠错等级按内容长度选最小够用的（L/M/Q/H 冗余约 7/15/25/30%），长内容用 H 会让模块密度超出分辨极限反而扫不出；② 生成时必须给足静区（margin: 4），它是解码器定位边界的前提，裁边或贴圆角会破坏它；③ 打印前算一下最小模块物理尺寸，300dpi 下不低于 0.33mm；④ 动态码（短链指向后端记录）内容可变可撤销但引入服务端依赖，静态码成本低无依赖但改内容就得换标签，按履约要求选。

// ① 按内容长度选纠错等级（不是越高越好）
function pickEcc(textLength) {
  if (textLength < 100)  return 'L'   // 约 7% 冗余
  if (textLength < 300)  return 'M'   // 约 15%
  if (textLength < 600)  return 'Q'   // 约 25%
  return 'H'                           // 约 30%，仅在内容短且需抗污损时用
}
// ⚠️ 内容长还选 H ⇒ 模块密度超出分辨极限 ⇒ 反而扫不出

// ② 生成时务必给足静区（quiet zone，通常 4 个模块）
import QRCode from 'qrcode'
const png = await QRCode.toBuffer('https://example.com/p/12345', {
  errorCorrectionLevel: 'M',
  margin: 4,              // ← 静区；设 0 会导致很多扫码器找不到边界
  width: 512,             // 物理尺寸要够大
})

// ③ 打印前自检：对比度与最小模块尺寸
function checkPrintable(svg, minModuleMm = 0.33) {
  // 300dpi 打印时，最小模块应 ≥ 0.33mm，否则热敏头或激光会糊掉
  const m = svg.match(/viewBox="0 0 (d+) (d+)"/)
  if (!m) return { ok: false, reason: '缺 viewBox，无法算模块尺寸' }
  const modules = Number(m[2]) - 8        // 减去 2×4 静区
  return { ok: true, modules, minMm: (512 / modules).toFixed(2) }
}

// ④ 动态码：短链 + 后端记录（内容可变、可撤销）
const code = await QRCode.toDataURL('https://s.example.com/' + token, { margin: 4 })
// 商品下架 / 召回：只改数据库记录，标签不用换

// ⑤ 静态码：内容直接编码（成本低，无依赖）
const staticCode = await QRCode.toBuffer(JSON.stringify({ sku: 'A-123', lot: 6 }), {
  errorCorrectionLevel: 'Q', margin: 4,
})
// ⚠️ 内容不可变 ⇒ 变更就意味着换标签

// ⑥ 一维码用于纯编号（更小的标签面积）
import JsBarcode from 'jsbarcode'
// Code128 可变长字符串，EAN-13 限 13 位数字
JsBarcode(svgEl, '1234567890123', { format: 'EAN13', margin: 10 })