Vue 3项目初始化需按需分层接入二维码功能:生成用qrcode,图片识别用jsQR,摄像头识别用@zxing/library;推荐Vite+TS创建,安装对应依赖及类型定义;组件应拆分为QrCode.vue(生成)、QrScanner.vue(识别)和类型文件;生成逻辑在setup中直接调用QRCode.toCanvas,识别优先支持上传图片,再按需扩展摄像头功能。

Vue 3 项目初始化时配置二维码生成与识别功能,核心是选对库、装对依赖、搭好基础结构,避免后期反复调整。重点不是堆功能,而是按需分层接入:生成用 qrcode,识别用 jsQR(图片)或 @zxing/library(摄像头),不强求一步到位。
1. 初始化项目并安装必要依赖
推荐使用 Vite 创建 TypeScript 项目:
npm create vite@latest my-qrcode-app --template vue-ts- 进入目录后一次性安装生成与识别所需库:
npm install qrcode jsqr @zxing/library @types/qrcode
说明:
– qrcode 负责生成 Canvas/SVG/DataURL 格式二维码;
– jsQR 轻量、纯前端、适合上传图片识别;
– @zxing/library 支持实时摄像头扫码,但需用户授权且注意移动端兼容性;
– @types/qrcode 是 TypeScript 项目必需的类型支持,避免编译报错。
2. 基础组件结构建议(单文件 + 可拆分)
不建议一上来就封装大而全的“二维码工具箱”。先建一个最小可用的 QrCode.vue 组件,目录如下:
-
src/components/QrCode.vue—— 主生成组件(含 input + canvas + download 按钮) -
src/components/QrScanner.vue—— 可选,独立识别组件(上传 or 摄像头) -
src/types/qr.ts—— 自定义类型,如QrOptions接口,统一管理 size/color/errorCorrection 等字段
这样后续扩展识别功能时,只需新增组件,不影响生成逻辑,也方便按需引入。
3. 生成功能:在 setup 中直接调用 qrcode API
无需额外封装类或 store,Composition API 下可直接响应式驱动:
- 用
ref管理文本内容、尺寸、颜色等参数 - 用
onMounted+nextTick确保 canvas 元素已挂载再调用QRCode.toCanvas() - 错误处理要显式捕获,比如内容为空、canvas 未就绪、编码失败等场景
示例关键片段:
const canvasRef = ref<htmlcanvaselement null>(null)<br>const text = ref('https://example.com')<br>const size = ref(200)<br><br>const generate = () => {<br> if (!canvasRef.value) return<br> QRCode.toCanvas(canvasRef.value, text.value, { width: size.value })<br> .catch(err => console.warn('二维码生成失败:', err))<br>}</htmlcanvaselement>4. 识别功能:区分场景选择实现方式
不要默认启用摄像头——它涉及权限、功耗、iOS Safari 兼容性等问题。优先支持“上传图片识别”,再按需加摄像头:
-
上传识别:监听
,用FileReader读取为Uint8ClampedArray,传给jsQR() -
摄像头识别:用
@zxing/browser的Html5QrcodeScanner,或手动调用MediaDevices.getUserMedia+Html5Qrcode,注意添加stop()控制生命周期 - 识别结果建议用
emit('scan', result)抛出,由父组件决定后续动作(跳转?提交表单?提示?)
识别不是“越快越好”,而是“稳定优先”——jsQR 对模糊、倾斜、低对比度图片较敏感,上线前务必实测常见截图和拍照场景。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











