从零开始教你用微信小程序开发一个完整购物商城

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

从零开始教你用微信小程序开发一个完整购物商城

打开微信开发者工具,新建一个项目,你会看到默认生成的页面结构和一堆配置文件。别急着删,先把它们搞清楚。`app.json` 是小程序的全局配置,里面管着页面路径、窗口样式、底部导航栏。做购物商城,底部导航通常放四个:首页、分类、购物车、我的。在 `app.json` 的 `tabBar` 字段里把这四个页面配好,每个页面对应一个 `pagePath`,再选一套图标。`app.wxss` 写全局样式,比如统一字体、颜色变量。`app.js` 处理全局逻辑,比如检查登录状态。这三个文件理清了,后面的页面开发才不会乱。

商品列表页是整个商城的门面。在 `pages` 目录下新建 `goodsList` 文件夹,里面放四个文件:`.js`、`.json`、`.wxml`、`.wxss`。`.wxml` 里用 `scroll-view` 做滚动容器,配合 `wx:for` 循环渲染商品卡片。每个卡片包含商品主图、标题、价格、销量。图片用 `mode="aspectFill"` 保证裁剪不变形。价格用红色加粗,销量用灰色小字。数据从哪来?先在 `.js` 的 `data` 里写死几条假数据,等页面跑通了再换成接口请求。`onLoad` 生命周期里调 `wx.request` 拿后端数据,注意把域名加到小程序后台的 `request` 合法域名列表里,否则真机调试会报错。

商品详情页要展示大图、价格、规格、详情描述和加入购物车按钮。页面跳转时通过 `url` 传商品 `id`,比如 `/pages/goodsDetail?id=123`。详情页的 `onLoad` 函数接收 `options` 参数,拿到 `id` 后再请求具体商品数据。规格选择用 `picker` 组件或者自己写一个弹出层,用户选完规格后把 `skuId` 存到 `data` 里。加入购物车不是简单往数组里 `push`,要考虑同一商品不同规格算不同条目。购物车数据存在 `wx.getStorageSync` 里,这样关掉小程序再打开数据还在。每次操作购物车后记得调 `wx.setStorageSync` 同步。

购物车页面逻辑比想象中麻烦。每条记录包含商品 `id`、规格、数量、选中状态。全选和反选要遍历整个数组改 `checked` 字段。数量加减用 `bindtap` 绑定事件,注意用 `data-index` 传索引,在事件对象里通过 `e.currentTarget.dataset.index` 拿到。总价计算不能每次 `setData` 都全量遍历,数据量大了会卡。可以维护一个 `totalPrice` 字段,在数量变化时增量更新。删除商品用 `wx.showModal` 弹确认框,用户点确定后再 `splice` 数组。购物车底部要留出结算栏,显示总价和结算按钮,按钮固定在底部用 `position: fixed`。

结算流程涉及订单确认页和支付。订单确认页展示收货地址、商品清单、总价。收货地址用 `wx.chooseAddress` 拉微信地址簿,用户授权后自动填入。支付调 `wx.requestPayment`,需要后端先调微信支付统一下单接口,返回 `timeStamp`、`nonceStr`、`package`、`signType`、`paySign` 五个参数。前端拿到后直接传给 `wx.requestPayment`。支付成功回调里跳转到订单详情页,同时清空购物车中已下单的商品。注意支付失败要给出提示,别让用户卡在原页面。订单状态用数字表示,比如 0 待付款、1 已付款、2 已发货、3 已完成,方便后端和前端统一处理。

用户中心页面看着简单,其实要处理登录态。微信小程序登录流程是:前端调 `wx.login` 拿 `code`,传给后端,后端用 `code` 加 `appid`、`secret` 调微信接口换 `openid` 和 `session_key`,然后生成自定义登录态返回给前端。前端把 `token` 存到 `storage` 里,后续请求都带上。用户头像和昵称现在不能用 `wx.getUserInfo` 直接拿了,得用 `button` 组件的 `open-type="chooseAvatar"` 和 `type="nickname"` 让用户主动授权。我的页面还要展示订单入口,按状态分 tab,每个 tab 请求不同状态的订单列表。订单列表用 `scroll-view` 加下拉刷新 `onPullDownRefresh`,体验会好很多。

后端接口这块绕不开。你可以用 Node.js 加 Express 快速搭一个,数据库用 MySQL 或 MongoDB。商品表存 `id`、`title`、`price`、`image`、`stock`、`detail`。订单表存 `orderNo`、`userId`、`goodsList`、`totalPrice`、`status`、`createTime`。购物车可以存前端 `storage`,也可以存后端数据库,看你想做多完整。接口用 RESTful 风格,`GET /api/goods` 拿列表,`GET /api/goods/:id` 拿详情,`POST /api/order` 创建订单。跨域问题在小程序里不存在,但要在微信后台配好合法域名。本地开发可以勾选“不校验合法域名”先跑通。

上线前有几件事必须做。一是用真机预览,iOS 和 Android 都跑一遍,检查 `fixed` 定位在键盘弹起时会不会错位。二是图片全部走 CDN,小程序包大小限制主包 2MB,图片放本地很容易超。三是 `setData` 别传大对象,只传变化的那部分数据,否则页面会明显卡顿。四是加 `loading` 状态,接口请求期间给用户反馈,别让页面白屏。五是错误处理,`wx.request` 的 `fail` 回调里要 `wx.showToast` 提示网络异常。做完这些,一个能跑通浏览、加购、下单、支付的购物商城小程序就算成型了。后面再慢慢加优惠券、秒杀、评价这些模块,都是在这个骨架上添肉。

原文来自:小程序开发