优先选用qrcode.js等成熟库而非手写canvas,因其支持tocanvas()和tosvg()、兼容性好且避免ecc、掩码等编码坑,使用时需确保dom就位并传入元素而非id字符串。

用 canvas 手动画二维码太麻烦,优先选成熟库
HTML5 本身不提供生成二维码的原生 API,硬靠 canvas 算点阵、编码、加定位图案,既容易出错又难维护。真实项目里没人这么干。
实操建议直接用轻量级库:qrcode.js(最常用)、qr-code-generator(纯 JS、无依赖)或 @chenfengyuan/vue-qrcode(Vue 场景)。它们都只输出一个 canvas 或 svg 元素,嵌入 HTML 即可。
- 别自己实现
QRCode.encode()逻辑——ECC 级别、掩码模式、版本选择全是坑 -
qrcode.js的toCanvas()方法兼容性好,但 IE11 需配canvas-toBlobpolyfill - 如果要打印或高清显示,优先用
toSVG(),避免canvas在高 DPI 屏幕上模糊
qrcode.js 怎么写进页面不报错
常见错误是脚本执行时 DOM 还没就位,或者漏传容器元素。
正确做法:等 #qrcode 容器存在后再调用,且确保传的是 DOM 元素,不是字符串 ID。
立即学习“前端免费学习笔记(深入)”;
注意:请在linux环境下测试或生产使用 青鸟内测是一个移动应用分发系统,支持安卓苹果应用上传与下载,并且还能快捷封装网址为应用。应用内测分发:一键上传APP应用包,自动生成下载链接和二维码,方便用户内测下载。应用封装:一键即可生成app,无需写代码,可视化编辑、 直接拖拽组件制作页面的高效平台。工具箱:安卓证书生成、提取UDID、Plist文件在线制作、IOS封装、APP图标在线制作APP分发:
- 错误写法:
QRCode.toCanvas("qrcode", "hello")—— 第一个参数必须是元素,不是字符串 - 正确写法:
QRCode.toCanvas(document.getElementById("qrcode"), "hello") - 如果用
async/await,注意toCanvas()返回Promise,但toDataURL()不返回 - 中文内容必须 UTF-8 编码,否则乱码;
qrcode.js默认支持,但老版本(typeNumber: 0
二维码内容含特殊字符或长 URL 怎么处理
URL 中的 &、=、/ 本身合法,但若未编码就直接塞进二维码,扫码后可能被浏览器截断或解析失败。
关键不是“能不能放”,而是“扫码设备怎么解”。手机微信、支付宝对未编码 URL 兼容性尚可,但部分工业扫码枪会严格按 URI 规范解析。
- 安全做法:用
encodeURIComponent()包一层,比如encodeURIComponent("https://a.com/?x=1&y=2") - 不要用
encodeURI()—— 它不编码/和:,导致路径结构丢失 - 超过 2953 字符(L 级纠错)会自动降级到更小版本,容量骤减;此时应启用 M 或 Q 纠错,并检查是否真有必要塞这么多内容
- 测试时务必用真实扫码设备扫,别只看 canvas 渲染效果
想改颜色、加 logo、控制大小怎么办
qrcode.js 原生不支持填色或嵌入图片,但可以操作生成后的 canvas 或 svg。
推荐路径:生成后用 JS 拿到 canvas,用 getContext("2d") 重绘;或用 toSVG() 输出字符串,再用 innerHTML 插入并修改 fill 属性。
- 改色最简方式:
QRCode.toCanvas(canvasEl, text, { colorDark: "#333", colorLight: "#fff" }) - 加 logo:先画二维码,再用
ctx.drawImage(logoImg, x, y, width, height)盖上去,注意别遮住三个定位角 - 控制大小:别调
width/height参数(那是 canvas 元素尺寸),真正影响码密度的是scale选项(如{ scale: 4 }) - 响应式场景下,避免用 CSS 缩放
canvas,会导致锯齿;应在 JS 里根据容器宽度动态重生成









