美团前端项目实践
说明:本篇内容为回忆录,仅以此记录当时的开发经历。原始代码仓库被删掉了
回忆说明
从 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)=> 模糊查询店名+菜名
- /static/scripts/search.js:
- 数据处理
- /utils/main.js:
listCopy(toList, copiedList)=> 给响应式的数组赋值,replace init_cart(),dish_dec(),dish_add()...
- /utils/main.js:
- 模糊搜索
- 数据结构
- 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 -- 封装的缓存读写操作
个人和团队
任务分工
- 页面布局(主 template 框架)
- 第一步搭建页面的布局结构
- 查看美团官网的界面,参考布局结构,借鉴灵感:
- 搜集 icon ,images 等资源
- 属性控制(主 scss 属性调整)
- 第二步调整元素的属性美化界面
- 浏览器 F12 打开开发者工具,查看美团界面的属性大小,颜色等进行借鉴调整
- 交互逻辑(主 js 事件逻辑)
- 第三步补充数据实现事件响应
- 参考美团的交互逻辑,模拟交互流程
- 准备数据,测试
- 页面布局(主 template 框架)
个人担任多种角色,根据任务分工依次完成对应部分的内容,项目线性进行,有条不紊
沟通
学习交流
- 与老师多次交流
- 与多名同学交流
- 与老师多次交流
互联网沟通
- 参考官方文档:uni-app 官网
- axios 文档:Axios 中文文档 | Axios 中文网
- B 站相关教程
- 各种相关帖子
- 与 AI 沟通问题
项目反馈
我完成的任务点
项目框架
- 路由配置:配置页面信息 + 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 变得不一样- 数据添加至缓存.缓存数据机制,快速加载
- 命名标准规范.组成成分.父类.子类...
- 优化数据结构,优化查询效率
原始视频演示
待添加。当前博客还不支持附件的管理,语法支持后,在自己的编辑器上,应该可以直接预览播放。暂时不添加。









