
文章分类:新闻资讯 发布时间:2026-11-20 原文作者:小程序开发 阅读( )

很多人第一次接触小程序二维码,是在餐厅点餐的时候。扫一下桌上的码,菜单直接跳出来,不用下载App,不用注册账号。但轮到自己要生成一个小程序码时,反而不知道从哪下手。小程序二维码分好几种类型,获取路径不一样,用错了场景还会出问题。今天就把这件事从头到尾捋一遍,争取看完不用再搜第二篇教程。
先说最基础的获取方式:小程序后台。登录微信公众平台,进入你管理的小程序,左侧菜单找到「设置」—「基本设置」—「小程序码及线下物料下载」。这里能下载到两种东西:一种是普通二维码(方形,中间带小程序Logo),另一种是小程序码(圆形,放射状图案)。两者扫出来都能打开你的小程序,区别在于小程序码视觉识别度更高,微信官方也更推荐在线下物料中使用。下载时可以选择尺寸,从430px到1280px不等,做海报建议选大尺寸,印刷用要下载矢量文件或者至少1280px以上。
后台下载的码有一个硬伤:只能指向首页。如果你想让用户扫码直接进入某个商品详情页、活动页或者特定参数页面,就得用带参数的小程序码。这就引出了第二种获取方式——通过微信提供的接口生成。具体来说,调用`wxacode.getUnlimited`这个接口,可以生成不限数量的小程序码,并且支持传入scene参数。比如你做一个线下投放,不同门店放不同的码,每个码里带上门店ID,用户扫码进来后小程序就能识别是哪个门店的客流。这个接口需要在服务端调用,用access_token鉴权,返回的是图片二进制流,保存成文件即可使用。
有人会问:我不会写代码,能不能生成带参数的小程序码?可以,用第三方工具。微信服务市场里有一些合规的第三方平台,提供可视化的小程序码生成功能。你授权小程序后,在界面上填写页面路径和参数,点生成就能下载。不过要注意,授权第三方意味着把一部分小程序管理权限交出去,选服务商时看清楚它的权限范围,别把开发管理权限也一并给了。另外,有些免费工具生成的码带有第三方水印或者跳转中间页,这种码扫出来会多一次跳转,用户体验差,还可能被微信判定为违规。
获取到二维码之后,怎么用也是门道。线下场景最常见的是贴桌上、印海报、放展架。这里有个细节:小程序码的扫码距离比普通二维码更远。普通二维码大概10到15厘米内识别最稳,小程序码可以拉到30厘米甚至更远,因为它图案更大、对比度更高。所以餐厅点餐码、景区导览码这类需要用户站着扫的场景,优先用小程序码。印刷时注意留白边,微信要求小程序码周围至少留出码本身宽度1/12的空白区域,否则可能扫不出来。
线上场景就更丰富了。公众号文章里可以插入小程序码图片,用户长按识别直接跳转。这里有个常见坑:公众号文章里长按识别小程序码,安卓和iOS的表现不一样。安卓通常直接弹出小程序卡片,iOS有时候会先跳到一个中间页再打开。这不是码的问题,是系统差异。想避免这个体验落差,可以在文章里同时放小程序卡片链接和小程序码图片,用户点卡片也行,长按识别也行。另外,微信群发图片时,小程序码可以被微信自动识别,但前提是图片没有被压缩得太厉害。发原图,别发经过多次转发的糊图。
还有一个高频问题:小程序二维码有效期吗?分情况。后台下载的普通二维码和小程序码,只要小程序不注销、不封禁,码就长期有效。通过接口生成的带参数小程序码,默认也是长期有效,但有个限制:`wxacode.getUnlimited`接口生成的码,scene参数最大32个可见字符,且只支持数字、大小写字母和部分特殊符号。如果你传了中文或者超长参数,生成会失败。另外,单个小程序通过该接口生成的码总量没有硬性上限,但微信对调用频率有限制,默认每天10万次,一般业务够用了。
说一个容易被忽略的问题:小程序二维码可以修改指向吗?答案是不能。码一旦生成,指向的页面路径和参数就固定了。如果你把线上一个码印了十万份海报,后来想改活动页面,只能重新生成新码重新印刷。所以投放前务必确认页面路径正确,参数逻辑跑通。有个取巧的办法:在小程序里做一个中转页,所有码都指向这个中转页,页面里再根据参数做二次跳转。这样以后改活动,只需要改中转页的逻辑,不用换码。代价是多一次跳转,但线下场景下用户感知不强,算是一个实用的折中方案。
回到标题里的问题——获取与使用,核心就三件事:后台下载用于通用场景,接口生成用于带参数场景,第三方工具用于无代码场景。使用上记住三条:线下优先小程序码、印刷留白边、投放前先自测扫码。微信官方文档写得很细,但都是技术语言,普通人看着费劲。如果还有没覆盖到的具体情况,比如小程序码在海外能不能扫、不同手机型号识别率差异,可以再单独聊。