结论先行:vueMinishop 是一套基于 Vue 的开源 H5 商城前端,后端完全由 api工厂 驱动。部署路径只有三步——克隆代码、配置你的专属 subDomain、构建后上传到任意静态空间。全程不需要自建服务器,也不需要写一行后端代码,商品、订单、支付全部在现成管理后台维护,前端代码则完全属于你。
一、项目定位与仓库地址
vueMinishop 是 api工厂 社区开源的移动端 H5 商城,覆盖商品列表、商品详情、购物车、下单支付、订单管理、用户中心等常见页面。它的最大特点是「前端开源、后端托管」:所有业务数据都来自 api工厂 的开放接口,项目本身不包含任何服务端代码,克隆下来改一个配置就能跑起来。
如果你的业务主战场在微信小程序,可以改用 wechat-app-mall;想一套代码同时发小程序和 H5,则选 uni-app-mall。这些项目都收录在开源项目大全中,并且共用同一套后台数据,切换前端形态不用迁移商品和订单。
二、准备工作:拿到你的 subDomain
- 在 https://admin.it120.cc/ 注册账号并登录后台;
- 在后台找到你的「专属域名」(subDomain),它是所有接口调用的唯一标识,相当于你站点的身份证;
- 本地准备 Git 与 Node.js 环境,建议使用常见的 LTS 版本,避免过新版本带来的依赖兼容问题。
费用方面:免费会员 0 元/年,提供 10 QPS,仅限非商业场景,用来开发调试足够;正式商用建议专业版 399 元/年(1000 QPS),流量大的业务可选增值版 988 元/年(50000 QPS,且全部付费插件免费)。详见价格页。注意会员不支持退款,下单前先确认需求匹配。
三、克隆与本地运行
git clone https://github.com/gooking/vueMinishop.git
cd vueMinishop
npm install
npm run dev然后在入口文件中找到 SDK 初始化位置,把示例域名换成你自己的专属域名:
WXAPI.init('你的subDomain')api工厂 所有 SDK 的返回结构统一为 {code, data, msg},code == 0 表示成功,非 0 时 msg 会给出原因。启动后如果首页能拉出 Banner 和商品列表,说明链路已通。对某个接口返回不确定时,先到在线 Playground 调试确认,再写进页面,能省掉大量盲猜时间。
四、后台配置:让商城有货可卖
前端只负责展示与交互,业务数据全部在管理后台维护,这也是「后台现成」的含义:
| 配置项 | 后台位置 | 说明 |
|---|---|---|
| 商品与分类 | 商城管理 | 支持多规格 SKU、库存、上下架 |
| 首页轮播 | Banner 管理 | 可跳转商品、文章或外部链接 |
| 运费规则 | 系统参数 | 满额包邮、到店自提等 |
| 在线支付 | 支付配置 | 微信支付、支付宝,跨境可选 PayPal/Stripe |
| 营销玩法 | 优惠券/拼团/砍价 | 开箱即用,前端按需接接口 |
H5 端的微信支付通常需要在微信公众号环境内发起,务必配置好支付授权目录;面向普通手机浏览器的场景,建议同时开启支付宝 H5 支付作为兜底,避免用户卡在付款环节。
五、构建与上线
npm run build把构建产物 dist 目录上传到任意静态空间即可:对象存储加 CDN、Nginx 静态目录、GitHub Pages 都可以。三种托管方式各有取舍:对象存储加 CDN 成本最低、抗流量冲击能力最强,适合大多数中小商城;自有 Nginx 便于做反向代理和灰度控制,适合已有服务器资源的团队;GitHub Pages 零成本但国内访问速度一般,只建议用于演示环境。
上线前做三件事:绑定自有域名并开启 HTTPS;为静态资源配置合理的缓存策略,HTML 短缓存、带指纹的 JS 与 CSS 长缓存;用真实商品走一遍「浏览—加购—下单—小额支付—后台发货」的完整闭环。支付回调、订单状态流转这些环节,只有真实跑过一次才算验收通过,切勿只在开发者工具里点一点就宣布上线。
六、二次开发与 SEO 提醒
想改主题色、加页面,直接在 Vue 组件层面动手即可,接口层不需要任何改动;新增业务能力(如积分签到、三级分销)时,先查 SDK 文档确认接口是否已存在,多数常见需求平台都有现成接口。需要提醒的是:纯 SPA 形态的 H5 商城对搜索引擎收录并不友好,如果你的业务依赖搜索流量,建议官网与资讯部分用静态化方案(例如社区开源的 apistatic 工具)单独生成,商城作为交易入口挂在其下。
七、上线后的运营与迭代
商城上线只是起点,后续运营动作大多也能在后台直接完成:发放优惠券拉新、配置拼团或砍价做裂变、用积分签到提升复购,这些能力平台均已内置,前端按文档接入对应接口即可,不必为每个活动单独开发后端。内容侧可以用 CMS 模块发布种草文章并关联商品,把「内容—商品—下单」串成一条链路。
迭代节奏上建议保持小步快跑:每次只改一个模块,改完在测试环境回归下单链路再发布;后台数据可通过导出功能定期备份商品与订单;遇到平台侧接口更新,关注更新日志即可,前端 SDK 升级通常是替换一个版本号的事。
八、常见问题速查
| 现象 | 常见原因 | 处理 |
|---|---|---|
| 接口返回非 0 | subDomain 配错 | 核对 init 参数与后台专属域名 |
| 页面白屏 | 静态资源路径错误 | 检查构建的 base/publicPath 配置 |
| 支付无响应 | H5 支付未配置 | 后台完成支付配置并核对发起环境 |
| 图片加载慢 | 原图过大 | 使用平台缩略图参数按需取图 |
文章标签
相关产品
api工厂是面向开发者的开放 SaaS 平台:开箱即用的后台管理系统 + 全端 SDK,只需前端开发即可构建小程序、App、H5 与网站。