02-美团前端项目实践

返回

美团前端项目实践 ​

说明:本篇内容为回忆录,仅以此记录当时的开发经历。原始代码仓库被删掉了

回忆说明 ​

从 2025 年 07 月 05 日 - 2025 年 07 月 11 日

当时正值大一下的暑假,大一时间基本上就学了 web 前端、C++、数据库,这是暑假小学期的为期一周的 uniapp 前端项目的学习,利用 Hbuilder 进行开发,后端用的 Python Flask。

当时是上一周的课,正常授课是每天上半天。我是三四班的同学,一二班跟我们是错开上课的,但是我一整天都去上课了,上午也在上,下午也在上。

学习的时候,基本上没听老师讲,自己看 uniapp 的官方文档,自己照着学,一个组件一个组件的试,因为开发语言是基于 Vue 的,所以,我去 bilibili 上直接学了 Vue 相关的课程视频,看了 Vue 框架的相关文档,还有 Vue 系统 的其他框架,把 Axios 调用也学了等等。

当时学习的时候,踩了很多很多坑,非常多的报错,尤其是异步调用、异步数据加载、组件生命周期、开源组件自定义样式修改不生效、控制台调试等问题,根本搞不清楚,半天搞不明白什么原因。

前端学习,印象最深的是 “渡一教育” ,我觉得讲得很好,我很有兴趣看,就算后来没学前端了,也乐意看一看他的视频,感觉很接地气。

最终完成的作业,就是仿造美团移动端的 web 前端项目。

最终收获关键词:模糊搜索、响应式、UI 组件、封装请求 axios、路由管理、前端调试、sass、Python Flask、本地缓存、元素层级控制、组件生命周期、异步加载等。

原始作业报告 ​

前端框架大作业


姓名:xxx

班级:20xx级软工中外x班

学号:xxx

简介

项目目标

  • 仿美团外卖小程序开发

课程目标

  • 布局美化

    • 界面布局

    • 细节美化

    • 资源获取

  • 逻辑交互

    • 配置全局文件
    • uniapp 内置组件的使用
    • uniapp 的 API 使用
    • 插件的使用
    • 运行逻辑的构建

设计/开发解决方案

软件算法流程

  • 算法
    • 模糊搜索
      • /static/scripts/search.js: blurQuery(_to_query, _shop_data, _dish_data, _shop_dish) => 模糊查询店名+菜名
    • 数据处理
      • /utils/main.js: listCopy(toList, copiedList) => 给响应式的数组赋值,replace
      • init_cart(), dish_dec(), dish_add() ...
  • 数据结构
    • shop_data、dish_data、cart_data、...

单元模块/构件

  • 模块化项目

    • 首页模块、餐厅模块、购物车模块、订单模块
  • 构件化页面

    • page、header、nav、content、card...

软件系统的设计

  • 系统结构化
    • /pages/ -- 页面管理(布局+响应式)
    • /static/ -- 静态资源
      • /images/ -- 图片资源
      • /scripts/ -- 页面相关的 js 函数 (因为不知道响应式数据能不能 import,所以只用来放复杂的函数方法)
      • /styles/ -- 样式调整
    • /utils/ --工具函数
      • main.js -- 通用的函数
      • request.js -- 封装的 axios 网络请求
      • storage.js -- 封装的缓存读写操作

个人和团队

  • 任务分工

    1. 页面布局(主 template 框架)
      • 第一步搭建页面的布局结构
      • 查看美团官网的界面,参考布局结构,借鉴灵感:
        • 美团外卖首页参考 订单列表参考 个人中心参考
        • 搜索页参考 搜索联想参考
      • 搜集 icon ,images 等资源
    2. 属性控制(主 scss 属性调整)
      • 第二步调整元素的属性美化界面
      • 浏览器 F12 打开开发者工具,查看美团界面的属性大小,颜色等进行借鉴调整
    3. 交互逻辑(主 js 事件逻辑)
      • 第三步补充数据实现事件响应
      • 参考美团的交互逻辑,模拟交互流程
      • 准备数据,测试
  • 个人担任多种角色,根据任务分工依次完成对应部分的内容,项目线性进行,有条不紊

沟通


项目反馈

我完成的任务点

项目框架

  • 路由配置:配置页面信息 + tabBar
  • 安装插件:sass-loader + axios
  • 前端框架:基于 vue3 的响应式框架 + v-for + @click + v-bind
  • 后端接口:基于 python 的轻量级 flask 接口
  • 储存数据:内置缓存 + MySQL 数据库
  • UI 组件库:uniapp 内置基础组件 + css 搭配 scss 的原生布局
  • 网络请求:封装 axios 网络请求 + 后端 api 的搭建
  • 地图定位:采用 uniapp 的 uni.getocation 基础 API 获取经纬度(仅测试)

首页模块

  • 分类导航:swiper 实现 banner 效果+点击跳转到对应的餐厅列表
  • 搜索框:简易模糊搜索店名+菜名
  • 热门推荐:后端 sort 排序模拟热门数据(功能未体现)(后端接口搭建)
首页界面搜索联想建议导航分类列表

餐厅详情页模块

  • 餐厅信息:具体的店铺页面显示展示相关信息
  • 菜品展示:菜品卡片+添加至购物车
  • 用户评价:搭建了数据库(暂未实现)(后端接口搭建)
  • 在线下单:暂未实现
餐厅详情与点餐

购物车模块

  • 商品展示:简陋的进行了呈现
  • 操作功能:与购物车逻辑类似(暂未实现)
购物车界面与本地缓存

订单模块

  • 订单列表:与购物车界面类似(暂未实现)
  • 订单详情:与店铺详情页面呈现类似(暂未实现)

结果展示

仿美团整体界面与流程总览


反思总结

待改进的点

  • 不规范(难以维护,一次性项目)

    • 何时加 <view> 用盒子嵌套,用法不规范
    • 标签命名不规范 container 、item ... 不知合适用哪个名,固定前缀后缀
    • 全局属性定义不全,没有规范全局属性,统一风格
    • 布局结构位置规划不清晰,哪些 position 是 absolute?relative;父元素的宽高?...
    • 样式写得比较混乱,难以维护
    • js 代码结构不清晰...
  • BUG

    • 购物车点击添加或删除菜品时,没有约束好行为,导致购物车的总金额为负数
    • 购物车页面的数据不是动态刷新的,得手动刷新。没用好 onLoad()
  • 逻辑

    • vue3 学的不扎实,用得不恰当,computed 没用起来
    • 数据是用到了才加载,而不是一打开页面就加载(加载缓存机制)
    • 数据冗余。要用什么数据请求什么数据,而不是请求所有的相关数据,造成性能下降,增大开销
  • 其他

    • 事件触发区域没控制精准
    • 页面响应式布局有待提高
    • 屎山代码
  • ...................................................................................................................................................................

原始经验 ​

  • 同一个 page 的目录下,导入的包会作用于当前目录下的所有文件,即同一个目录下,其中一个页面导入的文件,其他页面也会生效。至少样式会相互影响
  • 当根目录下面创建了一个文件时需要重新编译项目。当已有的文件发生改动时可以直接刷新
  • button 的 border 消不了,不能纯透明
  • scss 可以方便管理变量,计算属性的大小,建立属性之间值的关系
  • scss 可以变量分离,一个文件用来管理变量,另一个用来描述布局
  • v-show 后面跟的数据类型为 bool。错误的使用了“true”,字符串
  • 模糊查询就是查询是否包含文本信息。但是只支持全文本,并没有将文本拆开,逐个查询。words by words => word by word
  • 安装 axios; sass
  • 第一次安装 axios 失败。使用 npm list 查看安装的所有库
  • 子元素要加 position: absulote,需要给父元素设置 position: relative,才能相对绝对
  • 同步请求就是在.then()里面写代码。then 就是请求成功之后执行的函数部分;async+await 部分。看懂了现在
  • 响应式的数据,不能直接赋值使用=操作,要不然会丢失响应式。有啥用呢?动态数据,非静态。只能操作它的内部,ref 用.value,reactive 用函数方法实现增删元素
  • 获取数据是在用到对应的功能之后才获取数据,没用到的时候就不加载
  • <text> 标签不能当 <view> 使用。会导致 flex 变得不一样
  • 数据添加至缓存.缓存数据机制,快速加载
  • 命名标准规范.组成成分.父类.子类...
  • 优化数据结构,优化查询效率

原始视频演示 ​

待添加。当前博客还不支持附件的管理,语法支持后,在自己的编辑器上,应该可以直接预览播放。暂时不添加。