微信小程序二维码是打通线下引流与线上转化的关键入口。微信官方目前提供三种生成接口，各自在参数长度、数量限制和适用场景上有明确差异，选对接口是第一步。
两种接口的核心差异
wxacode.getUnlimited（不限制接口）是大多数场景的首选。该接口生成的小程序码永久有效，数量暂无限制，适合需要为大量商品、门店或用户生成个性化二维码的业务。小程序开发者需要注意的是，它通过scene参数传递页面参数，最大支持32个可见字符，只接受数字、大小写英文及部分特殊字符。如果你的业务参数超过32个字符，可以在数据库中建立一个简短ID，将完整参数与该ID对应，扫码后通过ID反查即可。
wxacode.get（基础接口）支持最长128字节的path参数，能承载更丰富的页面路径信息，但生成数量有限制，与wxacode.createQRCode合计不超过10万个，适合参数结构复杂但用量可控的场景。如果参数相同，重复调用不会额外消耗配额。
实际生成时的关键操作
所有接口都必须在服务器端调用，不可在小程序前端直接发起请求。基本流程是：先通过AppID和AppSecret获取access_token，再携带access_token调用对应接口，接口返回的是二进制图片buffer，服务端将其保存为文件或转成Base64返回给前端展示。
如果项目使用了微信云开发，可以直接通过云函数调用，无需自行管理access_token。以wxacode.getUnlimited为例，在云函数中配置”wxacode.getUnlimited”权限后，传入page（目标页面路径）和scene（页面参数）即可获取小程序码buffer，再上传至云存储供业务使用。
有一个容易踩的坑：page字段的页面路径必须是已发布的小程序页面，且路径前不能加斜杠，参数必须放在scene字段中而非page里。小程序端通过decodeURIComponent(options.scene)获取scene值后进行解析。
结合SEO的优化要点
小程序二维码本身不直接参与搜索引擎收录，但与小程序页面的搜索优化密切配合，能显著提升自然流量。微信搜索爬虫访问小程序页面时会携带特定user-agent「mpcrawler」和场景值1129，因此页面内跳转的URL必须能被直接打开，不依赖上下文状态。
具体做法上，建议页面跳转优先使用navigator组件，页面参数保持结构清晰、命名有含义的querystring格式，避免将JSON数据直接作为参数传递。同时通过sitemap配置引导爬虫抓取有效页面，屏蔽无搜索价值的路径，并利用页面路径推送能力丰富微信可收录的内容。
如果你的业务需要批量生成带参数的二维码，草料二维码等第三方工具支持导入Excel模板批量生码，单次上限500个，适合不具备开发条件但需要快速落地的运营场景。
