QR Code & Barcode Types Reference

Practical Snippet

Key points: (1) pick the smallest sufficient correction level by content length (L/M/Q/H give roughly 7/15/25/30% redundancy) — a long payload at level H pushes module density past what scanners resolve and stops reading; (2) always emit a full quiet zone (margin: 4), since decoders rely on it to locate the boundary, and cropping or wrapping onto a corner destroys it; (3) before printing, check the minimum module size in millimetres — at 300dpi keep it above 0.33mm; (4) choose between dynamic codes (short link to a server record, mutable and revocable but with a service dependency) and static codes (cheap and dependency-free but requiring a relabel when content changes) based on fulfilment needs.

// ① 按内容长度选纠错等级（不是越高越好）
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 })