02.7 uni-app 与小程序路线
所属:全栈开发面试题库 / 学习路径 / 02 App 端开发
本页目录
一、路线定位
这一条路线覆盖两类东西,必须分开理解:
- uni-app:Vue 语法 + 编译产物。同一份代码编译成 App、H5、各家小程序。强项是多端覆盖与前端人力复用,弱项是多端差异与复杂交互性能。
- 小程序:独立的平台生态。微信、支付宝、抖音各有运行时、组件、开放能力与审核规则。它的「双线程 + 受控组件」模型决定了不能按 Web 的方式写。
两者经常一起用:用 uni-app 或 Taro 写一套代码,编译出多个小程序与 App。但编译不等于适配,条件编译与平台差异处理才是主要工作量。
适合谁:前端背景、需要快速覆盖 App + 小程序 + H5 的团队;内容、电商、工具类业务;预算与人力有限的中小项目。不适合:强交互、复杂动效、重原生能力的产品。
二、阶段划分
| 阶段 | 主题 | 关键内容 | 产出 | 参考学时(全职) |
|---|---|---|---|---|
| U0 | Vue 与工程 | Vue 3 组合式 API、TS、Vite、目录约定 | 单页应用 | 2–3 周 |
| U1 | uni-app 基础 | 页面与生命周期、rpx、组件、uni.request、路由 |
多页 App | 3 周 |
| U2 | 多端差异 | 条件编译、平台判断、组件与 API 差异表 | 一套代码多端可跑 | 4 周 |
| U3 | 数据与云 | 请求封装、Pinia、本地缓存、uniCloud 云函数与数据库 | 含后端能力的 App | 4 周 |
| U4 | 发布链路 | App 打包与签名、wgt 热更新、各端小程序上传 | 多端产物 | 3 周 |
| U5 | 小程序专项 | 双线程、setData 优化、分包、开放能力、审核 |
可上线小程序 | 4 周 |
| U6 | 性能与排障 | 长列表、图片、首屏、包体、白屏排查 | 性能报告 | 3 周 |
合计约 23 周。若已熟悉 Vue,可压缩至 16–18 周。
三、知识点地图
| 模块 | 知识点 | 掌握程度 |
|---|---|---|
| Vue | 响应式原理、组合式 API、ref/reactive 区别 |
能讲清原理 |
| Vue | 组件通信、插槽、生命周期、Pinia 状态设计 | 会用 |
| uni-app | 页面栈与生命周期、onLoad/onShow/onReady 的时序 |
能讲清原理 |
| uni-app | 条件编译语法与使用边界、平台判断 | 能讲清原理 |
| uni-app | 组件与 API 的多端差异、降级方案 | 能讲清原理 |
| uni-app | rpx 换算、750 设计稿、安全区 |
会用 |
| uni-app | 打包配置、签名、渠道、wgt 更新 | 会用 |
| uni-app x | UTS 语言、uvue 渲染、与 Vue 的差异 | 了解 |
| 小程序 | 双线程模型、逻辑层与渲染层通信成本 | 能讲清原理 |
| 小程序 | setData 性能、数据量与频率 |
能讲清原理 |
| 小程序 | 分包、预加载、独立分包、按需注入 | 会用 |
| 小程序 | 登录态、code2session、支付、订阅消息 |
能讲清原理 |
| 小程序 | 审核规则、类目、隐私协议、域名白名单 | 能讲清原理 |
| 小程序 | Skyline 渲染引擎与 WebView 渲染差异 | 了解 |
| 工程 | 多端构建、环境变量、CI 产物矩阵 | 会用 |
| 质量 | 真机兼容、弱网、白屏与 crash 监控 | 会用 |
四、技术栈与常用框架
| 领域 | 首选 | 备选 | 说明 | 文档 |
|---|---|---|---|---|
| 框架 | uni-app(Vue 3) | Taro(React)、原生小程序 | Vue 背景选 uni-app,React 背景选 Taro | uni-app |
| 语言 | TypeScript | JavaScript | 多端字段差异多,类型能提前暴露问题 | TS 文档 |
| 构建 | Vite(CLI 模式) | HBuilderX 内置 | CLI 便于接 CI 与 Monorepo | uni-app CLI |
| 状态 | Pinia | Vuex(存量) | 组合式 API 配套 | Pinia |
| UI 库 | wot-design-uni | uView Plus、uni-ui | 组件覆盖与多端一致性要实测 | wot-design-uni |
| 请求 | uni.request 封装 |
自建拦截器 | 统一错误码、令牌刷新、重试 | API 文档 |
| 云能力 | uniCloud | 自建后端 | 云函数 + 云数据库 + 云存储 | uniCloud |
| 原生渲染 | uni-app x(UTS/uvue) | 传统 App 模式 | 追求性能时用,生态仍在成长 | uni-app x |
| 小程序框架 | 原生框架 | Taro、uni-app | 深度平台能力建议原生 | 微信文档 |
| 渲染引擎 | WebView | Skyline | Skyline 性能更好但组件与兼容性受限 | 微信文档 |
| 测试 | 真机自动化 | miniprogram-automator | 关键路径回归 | 各平台文档 |
| 监控 | 各平台后台 + 自建埋点 | 第三方 APM | 小程序侧要看平台性能面板 | 各平台文档 |
五、小程序运行机制与平台差异
| 维度 | 微信小程序 | 支付宝小程序 | 抖音小程序 | uni-app 处理方式 |
|---|---|---|---|---|
| 运行模型 | 逻辑层与渲染层双线程 | 类似双线程 | 类似双线程 | 框架抹平,但通信成本仍在 |
| 组件 | 内置组件 + 自定义组件 | 自有组件集 | 自有组件集 | 条件编译或运行时判断 |
| 登录 | wx.login + code2session |
my.getAuthCode |
tt.login |
封装统一登录服务 |
| 支付 | 微信支付 | 支付宝支付 | 抖音支付 | 分平台接入,服务端校验 |
| 消息 | 订阅消息 | 模板消息 | 订阅消息 | 各端模板 ID 独立配置 |
| 分包 | 支持,单包有大小限制 | 支持 | 支持 | 构建配置按端输出 |
| 审核 | 类目 + 内容 + 隐私 | 类目 + 资质 | 类目 + 内容 | 提前核对类目资质 |
三条必须记住的结论:
setData是性能瓶颈:一次传大数据会阻塞渲染层。只传变化字段,避免传整个列表。- 分包是包体硬约束:主包超限直接无法上传,必须提前规划分包与按需注入。
- 平台能力不可假设:登录、支付、订阅消息、分享、地理位置在各端 API 与审核要求都不同,必须逐端验证。
六、架构模式与状态管理选型
| 模式 | 结构 | 适用 | 注意 |
|---|---|---|---|
| 页面直连 | 页面内请求与状态 | 轻量、少量页面 | 多端差异会散落各处 |
| 分层(推荐) | 页面 → store → service → 请求层 | 多数 uni-app 项目 | 平台差异收口在 service |
| 平台适配层 | platform/ 目录按端实现,统一接口 |
多端差异大 | 接口先定义,避免各端各写 |
| 组件库 + 设计 Token | 主题变量 + 基础组件 | 多页面、多端 | 避免直接写死 rpx 与颜色 |
关键纪律:所有平台差异集中到适配层,页面里不写 #ifdef。条件编译用多了,代码会变成多份互不相识的分支。
七、设计软件与工具链
| 用途 | 工具 | 说明 |
|---|---|---|
| IDE | HBuilderX | uni-app 官方 IDE,运行与真机调试方便 |
| IDE(CLI) | VS Code | CLI 工程 + 插件,适合团队协作 |
| 设计稿 | Figma、MasterGo、即时设计、蓝湖 | 750 宽设计稿对应 rpx |
| 设计规范 | 微信小程序设计指南、WeUI | 小程序观感与交互基线 |
| 组件规范 | 各平台组件文档 | 不要照搬 Web 组件样式 |
| 图标 | iconfont、SVG | 小程序对字体图标支持有限,注意兼容 |
| 调试 | 微信开发者工具、支付宝/抖音开发者工具 | 真机预览与性能面板 |
| 抓包 | Charles、Proxyman | 小程序请求受域名白名单限制 |
| 自动化 | miniprogram-automator | 关键路径回归 |
八、官方文档与学习资源
- uni-app 官方文档
- uni-app CLI 工程
- uni-app API 与组件
- uniCloud 文档
- uni-app x 文档
- 微信小程序开发文档
- 微信小程序设计指南
- 支付宝小程序文档
- 抖音小程序文档
- Taro 文档
- Vue 3 文档
- Pinia 文档
九、出口验收
- [ ] 能用 Vue 3 + TS 写出去重、可复用的页面与组件。
- [ ] 能解释
onLoad/onShow/onReady的时序,并处理页面返回刷新。 - [ ] 能用条件编译与平台适配层处理三端差异,页面内不写平台分支。
- [ ] 能用 Pinia 管理状态,请求层统一处理令牌、错误与重试。
- [ ] 能用 uniCloud 或自建后端完成一次完整业务闭环。
- [ ] 能打包 App、上传小程序,并处理签名与审核问题。
- [ ] 能优化一次
setData卡顿、一次首屏白屏、一次包体超限。 - [ ] 能回答 07.2.4 uni-app 与 07.3 小程序开发 中的主要题目。
十、常见坑
| 现象 | 真实原因 | 纠正动作 |
|---|---|---|
| 小程序上传失败 | 主包超过平台限制 | 规划分包、按需注入、压缩资源 |
| 列表滚动卡顿 | setData 传整表或高频调用 |
只传变化项,合并更新,长列表分页 |
| 某些端样式错位 | 组件实现与默认样式不同 | 用适配层或条件编译,避免依赖 Web 特性 |
| 页面返回数据不刷新 | 未在 onShow 重新拉取或未订阅事件 |
统一页面刷新机制 |
| App 热更新不生效 | wgt 版本与基座不匹配 | 校验版本号与基座,注意商店政策 |
| 审核被拒 | 类目不符、隐私协议缺失、诱导分享 | 核对类目与平台规则,补齐隐私说明 |