从零开始开发一个微信购物小程序,完整实战指南

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

从零开始开发一个微信购物小程序,完整实战指南

上个月帮朋友做了个卖手工皮具的微信小程序,从注册账号到上线收款,前后折腾了二十来天。他之前找外包问过价,报价一万八,功能还只是最基础的商品展示加下单。我把他这个需求拆开一看,其实核心就三块:能看货、能下单、能收钱。微信官方把支付、登录、消息通知这些最难啃的骨头都封装好了,剩下的就是搭页面、连数据、调接口。这篇文章就把整个过程捋一遍,给想自己动手的人一个能照着走的路线图。

动手之前先把账号的事办了。打开微信公众平台,注册一个“小程序”类型的账号,注意别选成公众号,两者后台不互通。注册完进入后台,在“开发管理”里找到AppID,这串字符是你项目的身份证,后面所有配置都要用到。类目选择上,卖实物选“电商平台”或“商家自营”,卖虚拟商品选“教育”或“工具”,选错了审核会被打回来。支付功能需要额外申请微信支付商户号,提交营业执照和法人身份证,审核一般一到三天。个人主体也能注册小程序,但没法开通支付,只能做展示用,想收钱就必须是企业或个体工商户。这一步卡住了后面全白搭,所以先把资质的事跑通再动代码。

开发工具用微信官方那套就行,下载稳定版,装好后扫码登录,新建项目时把AppID填进去。前端框架推荐用原生小程序语法加一个UI库,比如Vant Weapp或TDesign,省得自己从头写按钮和弹窗。项目目录结构要清晰,pages放页面,components放公共组件,utils放工具函数,config放接口地址和常量。商品列表页用scroll-view做滚动容器,每个商品卡片用flex布局,图片加懒加载,价格用红色加粗突出。详情页放个大图轮播,下面接规格选择器,用户点“加入购物车”时把商品ID和规格拼成一个对象存到全局状态里。购物车页面要处理选中状态和数量增减,总价实时计算,这些逻辑用computed属性实现最省事。

后端这块看你怎么选。如果只是小规模卖货,直接用微信云开发最省心,数据库、存储、云函数全在云端,不用买服务器也不用配域名。云数据库建三个集合:goods存商品信息,orders存订单,carts存购物车。云函数写一个createOrder,在里面调用微信支付的统一下单接口,把返回的支付参数扔给前端调起付款弹窗。用户付完款,微信会往你配置的回调地址发通知,在云函数里处理这个通知,更新订单状态为“已支付”,同时给用户发个订阅消息提醒发货。如果不用云开发,那就得自己搭服务器,Node.js加Express或者Koa都行,数据库用MySQL或MongoDB,域名必须备案且走HTTPS,微信要求所有请求地址都得是加密的。

支付环节是整个流程里最容易出岔子的地方。统一下单接口需要传openid、订单号、金额、回调地址这些参数,金额单位是分,别搞错了。调起支付的那段代码要放在后端签名,前端只负责拿参数唤起微信的支付窗口。用户付完款后,微信会异步通知你的服务器,这个通知必须返回success,否则微信会一直重试。处理通知时先验签,确认是微信发来的再改订单状态。退款功能也走微信的退款接口,需要证书文件,在商户平台下载后放到服务器安全目录里。有个细节要注意:支付和退款的回调地址不能带参数,必须是纯路径,否则微信会报错。

商品管理和订单处理得有个后台。云开发的话直接用云开发控制台就能增删改查,但给运营人员用不太友好。花半天时间用云开发的管理端SDK搭个简易后台,能上传商品图片、改价格、看订单列表就行。订单状态分几种:待付款、待发货、已完成、已取消。用户取消订单时要把库存加回去,这个逻辑写在云函数里保证原子性。发货时填快递单号和物流公司代码,用户在小程序里能直接看到物流轨迹。订阅消息要提前在后台申请模板,比如“订单发货通知”“退款到账通知”,用户下单时弹窗让他授权,授权一次只能发一条,所以要在关键节点引导用户勾选“总是保持以上选择”。

上线前有几件事必须做。在小程序后台配置服务器域名,把request合法域名、uploadFile合法域名、downloadFile合法域名都填上,云开发的话不需要配域名。隐私协议要写清楚收集了哪些用户信息、用来干什么,2023年9月之后微信强制要求配置隐私弹窗,不配的话审核直接拒。版本发布先传体验版,自己用手机扫码走一遍完整流程:浏览商品、加购物车、下单、支付、查看订单、申请退款。确认没问题再提交审核,审核一般一到两天,遇到周末会顺延。审核通过后点“发布”,用户就能搜到你的小程序了。

回头看这二十多天,真正写代码的时间不到一半,剩下的都花在注册账号、申请支付、配置域名、等审核这些杂事上。技术本身没有多高深,微信把复杂的部分都封装成了接口,你需要的是耐心和细心。建议先从云开发入手,跑通一个最小闭环——能展示一个商品、能下单、能付款——然后再往上加功能。别一上来就想着做淘宝,先把一单真实的交易跑通,后面的事就顺了。

原文来自:小程序开发