巴爷商城小程序:wechat_mall_applet 导入与后端接口配置指南
wechat_mall_applet 是巴爷商城的微信小程序版本,为「巴爷微信商城」的简单版,实现首页商品浏览、分类浏览、加入购物车、编辑收货地址,并通过 API 与后端通信完成获取商品、提交订单、支付等流程。
一、项目官方信息
| 项目 | 信息 |
|---|---|
| GitHub 仓库 | https://github.com/bayetech/wechat_mall_applet |
| 参考后端 | https://github.com/bayetech/wechat_mall_applet_backend |
| 线上商城 | https://wechat.bayekeji.com |
| 开源协议 | MIT |
| 主要语言 | JavaScript(100%) |
| Star 数 | 528+ |
二、官方图片
巴爷商城小程序截图:


三、环境要求
- 微信开发者工具;
- 需要一个可用的后端 JSON API 服务配合(仓库提供了一个参考后端实现);
- 一个属于你自己的小程序 AppID(示例 AppID 与服务器端配置绑定,不能直接用)。
四、部署/接入步骤
1. 克隆工程
git clone https://github.com/bayetech/wechat_mall_applet.git
2. 用微信开发者工具导入工程
打开微信开发者工具 → 导入项目 → 选择本工程目录 → 填入你自己的小程序 AppID。
3. 配置后端接口地址
在代码中把后端 API 地址改为你自己的服务地址。仓库提供了一个参考后端实现:
https://github.com/bayetech/wechat_mall_applet_backend
但几乎肯定仍需要自己写/改一个后端,因为示例 AppID 与官方测试服务器的 AppID 一致,填错 AppID 无法完成微信登录。
4. 编译预览
在开发者工具中编译,即可看到首页商品列表、分类、购物车等页面。
五、使用方法
已实现功能
- 首页商品浏览;
- 分类商品浏览;
- 加入购物车;
- 编辑收货地址;
- 通过 API 与后端通信(获取商品列表、提交订单、付款等)。
后端对接说明
前端通过 RESTful JSON 接口与后端交互:商品列表、分类、购物车、订单提交、支付等请求都指向后端服务。参考后端仓库仅作起步参考,实际业务需自行扩展数据模型与接口。
六、常见问题 FAQ
Q1:这个项目是什么? 巴爷商城的微信小程序版,实现商品浏览、购物车、收货地址与订单支付的前端流程。
Q2:直接导入就能跑吗? 不能直接用示例 AppID。示例 AppID 与官方测试服务器配置绑定,需要换成你自己的 AppID 并配套自己的后端。
Q3:有参考后端吗? 有,仓库 https://github.com/bayetech/wechat_mall_applet_backend ,但通常仍需自己写后端。
Q4:为什么有些商品显示不出来? 官方 README 说明:测试服务器可能存在其他同事新建的不完整测试商品,导致商品无法正常显示,属正常现象。
Q5:为什么登录失败? 填错 AppID 会导致与服务器端配置的 AppID 不一致,无法从微信获取用户数据,必须用自己的 AppID 并配套后端。
Q6:支持哪些核心功能? 首页/分类浏览、购物车、收货地址编辑、通过 API 获取商品/提交订单/支付。
七、跳转链接
- GitHub 仓库:https://github.com/bayetech/wechat_mall_applet
- 参考后端:https://github.com/bayetech/wechat_mall_applet_backend
- 线上商城:https://wechat.bayekeji.com