微信小程序二维码生成教程(详细步骤+注意事项)一、生成基础二维码(无需开发)适用场景:快速生成小程序首页/指定页面二维码,无需参数。
登录微信公众平台
进入「小程序管理」→ 选择对应小程序 → 点击「设置」。
找到二维码生成入口
在左侧菜单选择「开发管理」→ 点击「开发设置」→ 底部找到「小程序码」或「二维码」。
生成二维码
小程序码(圆形):识别更快,支持微信内长按识别。
普通二维码(方形):兼容性更广,可跨平台使用。
输入需跳转的页面路径(如 pages/index/index),点击「生成」。
下载使用
支持下载不同尺寸(建议8cm/4cm印刷使用)。
右键保存图片或扫码预览。
二、生成带参数二维码(需开发)
适用场景:追踪不同渠道用户来源(如广告、活动页)。
获取接口权限
确保小程序已发布,且管理员已开通「获取用户二维码」权限。
调用微信API生成
接口选择:
wxacode.get:生成数量有限(10万个/天)。
wxacode.getUnlimited:生成数量无限制(需小程序已认证)。
参数配置:
path:页面路径(如 pages/detail?id=123)。
scene:自定义场景值(如 channel=ad_baidu)。
代码示例(Node.js)
javascript
const axios = require('axios'); | |
async function createQRCode() { | |
const appId = '你的小程序AppID'; | |
const secret = '你的AppSecret'; | |
const access_token = await getAccessToken(appId, secret); | |
const response = await axios.post( | |
`https://api.weixin.qq.com/wxa/getwxacodeunlimit?access_token=${access_token}`, | |
{ | |
scene: 'channel=ad_baidu', // 自定义参数 | |
page: 'pages/index/index' // 跳转页面 | |
}, | |
{ responseType: 'stream' } | |
); | |
// 保存二维码到本地 | |
response.data.pipe(require('fs').createWriteStream('qrcode.png')); | |
} |
解析参数(小程序端)
在目标页面的 onLoad 生命周期中获取场景值:
javascript
Page({ | |
onLoad(options) { | |
const scene = decodeURIComponent(options.scene); | |
console.log('渠道来源:', scene); // 输出: channel=ad_baidu | |
} | |
}); |
三、测试与调试
预览二维码
使用微信开发者工具扫描生成的二维码,检查跳转是否正确。
监控扫描数据
进入「小程序管理」→「数据分析」→「访问分析」→ 查看「场景值」分布。
四、高级技巧
动态参数:通过服务端生成不同 scene 值的二维码,实现用户行为追踪。
批量生成:使用脚本循环调用API,生成多个带不同参数的二维码。
短链结合:将二维码链接通过短网址服务(如Bitly)缩短,便于传播。
注意事项
路径合法性:确保 path 在小程序 app.json 的 pages 字段中定义。
参数长度限制:scene 最大长度32个字符(中文需URL编码)。
二维码有效期:未发布的微信小程序仅支持生成100个测试二维码。
合规使用:禁止生成诱导分享、违规内容的二维码,否则将被封禁。
完整流程示例:
广告渠道A → 生成带参数二维码(scene=ad_a)→ 用户扫描 → 进入小程序首页 → 后台统计到scene=ad_a的访问量。