讲师中心 微信公众号
AI工具推荐 视频效率加速

uni-app二维码生成 uni-app如何动态生成二维码图片

酷雪小哥_3982

酷雪小哥_3982

发布时间:2026-03-21 19:08:03

|

484人浏览过

|

来源于php中文网

原创

uni-app跨端生成二维码需用uQRCode等适配库,因qrcode.js依赖浏览器canvas在非H5端不可用;uQRCode封装了多端绘制与导出逻辑,支持一行代码获取临时路径或base64。

uni-app 里不能直接用 qrcode.js 生成图片

因为 qrcode.js 默认依赖浏览器的 canvas api,而 uni-app 的非 h5 端(如微信小程序、app)不支持原生 canvas dom 操作,直接引入会报 cannot read property 'getcontext' of null 或白屏。

真正能跨端生成二维码图片的,只有 uni-app 官方封装的 uni.canvasToTempFilePath + 自研绘图逻辑,或使用适配多端的轻量库(如 weapp-qrcode 或 uQRCode)。

  • 微信小程序:必须用 canvas 绘制,再调用 uni.canvasToTempFilePath
  • H5 端:可用 qrcode.js 直接输出 canvas 或 img,但要注意 DOM 注入时机
  • App 端(nvue):不支持普通 canvas,需改用 native canvas 或服务端生成
  • 推荐优先用 uQRCode(专为 uni-app 写的,已处理多端差异)

用 uQRCode 动态生成二维码图片(推荐方案)

它把 canvas 绘制、临时文件转换、错误兜底都封装好了,一行代码就能拿到 base64 或临时路径,且支持 Promise。

安装:npm install uqrcodejs,然后在页面中:

import uQRCode from 'uqrcodejs'

调用示例:

uQRCode.make({
  text: 'https://example.com?id=123',
  size: 200,
  margin: 4
}).then(res => {
  // res.tempFilePath 是小程序/App 的临时路径,H5 下是 base64
  this.qrCodeUrl = res.tempFilePath
})
  • text 必填,必须是字符串;若含中文,确保已 encodeURIComponent(uQRCode 不自动编码)
  • size 单位是 px,建议设为偶数,避免某些端渲染模糊
  • margin 是白边宽度,设为 0 可能导致扫码失败(部分扫码器要求留白)
  • 生成结果不是 data: URL,而是平台原生临时路径(小程序)或 base64(H5),直接赋给 <image> src 即可

手动用 uni.createCanvasContext 绘制(仅限小程序)

如果你需要完全控制样式(比如加 logo、改颜色、圆角模块),就得自己画。但注意:这写法在 H5 和 App 端无效,必须配合条件编译。

关键步骤:

  • 模板里加一个隐藏的 <canvas canvas-id="qrCanvas" style="width: 0; height: 0;"></canvas>
  • 用 uni.createCanvasContext('qrCanvas', this) 获取上下文
  • 先调用 qrcode.js 的 createQrCodeImg(需改写为返回点阵数据)或用 uQRCode 的 getMatrix 方法获取二维数组
  • 遍历矩阵,用 fillRect 逐块绘制黑点(注意坐标换算和像素对齐)
  • 最后调用 uni.canvasToTempFilePath 导出图片

容易踩的坑:canvasToTempFilePath 必须在 draw 回调执行后调用,否则返回空路径;且 H5 下该 API 不存在,必须加 #ifdef MP-WEIXIN 包裹。

动态更新时别忘了清空 canvas 和重置状态

连续生成多个二维码时,如果复用同一个 canvas-id,旧内容可能残留,导致新码错乱或模糊。

  • 每次生成前,先调用 context.clearActions()(如果用了 save/restore)
  • 更稳妥的是:每次生成都新建一个带唯一 canvas-id 的 canvas 节点,用完即删(v-if 控制)
  • 如果用 uQRCode.make,它内部已处理清理,但你仍需确保传入的 text 是新值——别因为响应式没触发,还在用上一次的 data
  • 真机调试时,微信开发者工具可能缓存 canvas 输出,关掉「开启调试」再重试

最麻烦的其实是安卓微信里 canvas 渲染偏移、像素模糊,这时候与其硬调,不如把 size 提到 300+,再用 CSS 缩放控制显示大小。

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2563

2023.08.11

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

5543

2023.10.09

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

6550

2024.03.19

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

6198

2024.03.22

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

883

2024.05.22

html5动画制作有哪些制作方法
html5动画制作有哪些制作方法

html5动画制作方法有使用CSS3动画、使用JavaScript动画库、使用HTML5 Canvas等。想了解更多html5动画制作方法相关内容,可以阅读本专题下面的文章。

4211

2023.10.23

canva可画使用技巧汇总
canva可画使用技巧汇总

本专题汇集了PHP中文网精心整理的Canva可画新手使用技巧大全,专为零基础用户打造。无论你是想制作精美海报、PPT还是社交媒体配图,这里都有从注册登录、模板搜索到AI辅助设计、导出分享的全流程保姆级教程。通过深入浅出的图文指南,帮助你快速跨越设计门槛,轻松掌握Canva可画的实用操作,让每个人都能成为设计达人!

264

2026.05.19

OpenJDK JVM参数怎么调优
OpenJDK JVM参数怎么调优

Java应用运行缓慢,如何调整JVM参数?本专题介绍OpenJDK JVM性能调优的基本流程,涵盖性能指标确认、运行数据采集、内存配置和垃圾回收分析,帮助你先定位瓶颈,再通过对照测试验证效果,避免直接套用参数而影响应用稳定性。

80

2026.10.16

OpenJDK怎么配置Java开发环境
OpenJDK怎么配置Java开发环境

怎样用OpenJDK搭建开发环境?本专题介绍版本选择、下载安装、环境变量配置和编译运行验证,帮助你理清JDK的作用及基本配置流程,并通过简单程序检查环境是否可用,为后续项目开发做好准备。

40

2026.10.16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn