HTML二维码本质是静态图像,动态生成需手动触发重绘;关键在绑定数据变更时机,而非格式本身;带Logo或自定义样式时更需选择支持完整生命周期控制的库。

HTML二维码本身不支持动态生成,本质是静态图像
HTML里所谓“二维码”基本都是用 canvas 或 img 标签展示的,无论用 qrcode.js、qr-code-generator 还是服务端返回的 data:image/png;base64,...,最终渲染的都是一张位图或 SVG。它没有“动态更新”的能力——改了数据,必须重新调用生成函数、重绘 canvas 或替换 src。
常见误区是以为把 id="qrcode" 的 div 丢给某个库就能自动响应数据变化,其实不会。库只负责“一次性画出来”,后续数据变了,得你手动触发重绘。
- 用
qrcode.js时,每次内容变更必须调用qrCode.makeCode(newContent),否则 DOM 不变 - 用
canvas手动绘制时,需先ctx.clearRect()再重绘,否则新码叠在旧码上 - 用
img标签 + 后端 API 时,得换src并加时间戳防缓存:qr.png?text=xxx&t=1715829300
动态生成的关键在于“谁控制更新时机”
真正决定是否能动态生成的,不是二维码格式,而是你绑定数据变更的方式。比如:
- Vue 项目中,
v-model绑定输入框,watchtext后调用qrCode.clear(); qrCode.makeCode(text) - React 中,在
useEffect里监听依赖项,变化时重新生成并写入ref.current对应的div - 纯 JS 场景下,给
input加input事件,而非change(后者只在失焦触发,不够实时)
注意:频繁重绘 canvas 本身开销不大,但若每敲一个字就生成一次二维码(尤其含 logo、高纠错等级时),可能卡顿。建议加防抖,比如 setTimeout 延迟 300ms 再生成。
带 Logo 或自定义样式的 HTML 二维码更难动态化
一旦在二维码里嵌入图片、修改模块颜色、加圆角等,几乎所有轻量库(如 qrcodejs2)就不再支持直接更新——它们内部没暴露重绘接口,或重绘会清空 logo 层。
将 Markdown 文章转换为微信公众号兼容的纯 HTML 格式。当用户要求"转成微信格式"、"生成公众号文章 HTML"、"排版到微信草稿箱"、"微信粘贴格式"时触发。输出带内联样式的纯 HTML,微信编辑器可直接渲染,无需额外适配。支持标题、段落、列表、粗体、行内代码、表格、引用块、代码块、配图的完整转换。
-
qrcode.js的makeCode()会完全重置整个canvas,logo 需要你手动用drawImage()再贴一次 - 某些封装库(如
easyqrcodejs)提供clear()和render(),但 logo 路径必须在每次render()前重新传入配置对象 - 服务端生成方式最稳定,但每次改内容都要发请求,不适合高频交互场景
如果你需要 logo + 实时编辑,优先选支持完整生命周期控制的库,而不是“一行代码生成”的极简方案。
移动端扫码兼容性比动态逻辑更值得提前验证
动态生成本身没问题,但很多问题出在生成结果上:比如 canvas 导出为 PNG 时透明背景被转成黑底,iOS Safari 对 toDataURL('image/png') 的尺寸限制(超 4096px 可能截断),或安卓微信内置浏览器对 data URL 的长度限制(约 2000 字符)。
- 测试时务必用真机扫码,别只看 DOM 里的图像是否显示正常
- 含中文或特殊符号的内容,确保生成前已用
encodeURIComponent编码,否则部分扫码器无法识别 - 避免把大段 JSON 直接塞进二维码——先压缩(如
lz-string),再编码,否则容易超出容量
动态生成的麻烦从来不在“怎么刷出来”,而在于刷出来的那个码,能不能被扫出来、扫得快不快、扫得全不全。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










