一、项目背景及简介

背景
在移动互联网碎片化发展趋势下，企业需同时维护微信小程序、H5、App等多端应用，传统开发模式存在重复开发、维护成本高、迭代效率低等问题。

项目简介
《小兔鲜儿》是基于 Vue3 + TypeScript + UniApp 开发的跨端电商解决方案，覆盖微信小程序、H5、App三端（预留PC端和管理后台扩展能力）。通过一套代码实现多端部署，显著降低开发成本，提升交付效率。项目已上线微信小程序，支持商品浏览、购物车、订单管理、微信支付等核心电商功能。

二、目标客户

1. 中小型电商企业

• 需要快速搭建多端电商平台的商家
• 预算有限但希望覆盖微信、浏览器、App等多渠道的用户
• 开发者与技术团队
• 学习Vue3+TS+UniApp跨端开发的技术实践案例
• 寻求高效状态管理（Pinia）和组件化开发方案的团队
• 电商创业者
• 需验证商业模式的最小可行产品（MVP）
• 希望快速上线并迭代功能的初创团队

---






三、平台定位

1. 多端覆盖

• 微信小程序：轻量级入口，依托微信生态流量
• H5端：兼容浏览器访问，适合营销活动页
• App端：提供原生体验，支持复杂交互（如AR试妆）

• 统一后端接口（RESTful API），适配多端请求差异
• 通过条件编译实现平台特有功能（如微信支付 vs 支付宝支付）

• 预留PC端和管理后台接口，支持未来全渠道运营

四、平台技术

关键技术点

• 条件编译示例：

  // 微信支付特有逻辑
  /* #ifdef MP-WEIXIN */
  wx.requestPayment({...});
  /* #endif */
  
  // App端支付逻辑
  /* #ifdef APP-PLUS */
  uni.requestPayment({ provider: 'wxpay', ... });
  /* #endif */
  

五、平台核心功能

工程结构解析

├── .husky                     # Git Hooks
├── .vscode                    # VS Code 插件 + 设置
├── dist                       # 打包文件夹（可删除重新打包）
├── src                        # 源代码
│   ├── components             # 全局组件
│   ├── composables            # 组合式函数
│   ├── pages                  # 主包页面
│       ├── index               # 首页
│       ├── category            # 分类页
│       ├── cart                # 购物车
│       ├── my                  # 我的
│       ├── goods               # 商品详情
│       └── hot                 # 热门推荐
│       └── login               # 登录页
│   ├── pagesMember            # 分包页面(用户模块)
│       ├── address             # 地址管理
│       ├── address-form        # 地址表单
│       ├── profile             # 用户信息
│       └── settings            # 用户设置
│   ├── pagesOrder             # 分包页面(订单模块)
│       ├── create              # 创建订单
│       ├── detail              # 订单详情
│       ├── list                # 订单列表
│       └── payment             # 支付结果
│   ├── services               # 所有请求
│   ├── static                 # 存放应用引用的本地静态资源的目录
│       ├── images              # 普通图片
│       └── tabs                # tabBar 图片
│   ├── stores                 # 全局 pinia store
│       ├── modules             # 模块
│       └── index.ts            # store 入口
│   ├── styles                 # 全局样式
│       └── fonts.scss          # 字体图标
│   ├── types                  # 类型声明文件
│   ├── utils                  # 全局方法
│   ├── App.vue                # 入口页面
│   ├── main.ts                # Vue初始化入口文件
│   ├── pages.json             # 配置页面路由等页面类信息
│   ├── manifest.json          # 配置appid等打包信息
│   └── uni.scss               # uni-app 内置的常用样式变量
├── .eslintrc.cjs              # eslint 配置
├── .prettierrc.json           # prettier 配置
├── .gitignore                 # git 忽略文件
├── index.html                 # H5 端首页
├── package.json               # package.json 依赖
├── tsconfig.json              # typescript 配置
└── vite.config.ts             # vite 配置

1. 商品系统

• SKU选择器（多规格组合计算）
• 图片懒加载优化性能

• 购物车（本地存储+云端同步）
• 微信支付集成（JSAPI调用）

• 微信登录（uni.login获取code）
• 手机号绑定（getPhoneNumber组件）

• 状态机设计（待付款→已发货→已完成）
• 物流信息追踪

功能流程图

首页 → 商品详情 → 加入购物车 → 提交订单 → 微信支付 → 订单管理

六、平台独特优势

1. 开发效率提升

• 代码复用率达85%，三端共享业务逻辑
• 对比原生开发，周期缩短60%

• 分包加载（减少首屏加载时间）
• 骨架屏+预加载提升用户体验

• 兼容微信小程序、H5、App（iOS/Android）
• 支持扩展至PC端和管理后台

数据对比

七、平台配置安装与部署说明

开发环境要求

• 操作系统：Windows 11 / macOS 15.0
• 工具链：
• VS Code（代码编辑）
• HBuilderX（UniApp开发）
• 微信开发者工具（小程序调试）
• Node版本：v16.15.0 / v22.15.0
• 包管理：pnpm v8.6.10+

部署步骤

1. 克隆仓库

   git clone https://gitcode.com/Megasu/uniapp-shop-vue3-ts.git
   

2. 安装依赖

   pnpm install --registry=https://registry.npmmirror.com
   

3. 运行命令

   平台	命令
   微信小程序	npm run dev:mp-weixin
   H5	npm run dev:h5
   App	HBuilderX → 运行到手机/模拟器

八、应用场景及案例说明

场景1：新品牌快速上线

• 某美妆品牌需在1个月内上线小程序商城，通过小兔鲜儿方案：
• 2周完成开发，1周测试上线
• 覆盖微信、H5双渠道，首月GMV突破50万元

场景2：传统零售数字化转型

• 某连锁超市需拓展线上渠道：
• 基于小兔鲜儿开发App端，支持会员积分、优惠券核销
• 结合UniCloud实现门店库存实时同步

案例效果

• 用户增长：小程序上线30天DAU突破5000
• 成本降低：单端开发成本从25万元降至10万元