小程序和 APP 一套代码复用,前端工程化该怎么做?

4 阅读4分钟

接过一个项目,小程序和 APP 两套代码并行维护半年,同一个促销规则改了两遍还改漏一次。回头看技术方案,问题不在框架选型,在于没人把"平台差异"当成需要收敛的东西。

多端复用的关键不在框架,在把平台差异收敛到一个可枚举的适配层,其余 80% 的业务代码按标准分层写。做到这一点,前端工程化与体验性能优化才有讨论的基础。

先压住构建时间和产物体积

多数项目的构建时间是在依赖图失控后变长的。三个动作最有效:按路由拆包,业务模块不进主包;依赖做显式外置,同一版本只保留一份;构建缓存打开,node_modules 与构建产物分离缓存。

miniprogram 侧的配置示例:

Web 侧对应的是路由级动态 import 加 manualChunks,把框架、UI 库、业务各自成块。别把所有第三方塞进一个 vendor,改一行业务代码就让用户重下 2MB 的包,是首屏最贵的一笔开销。

基线指标建议写进 CI:主包体积上限、首屏 JS 体积上限、构建耗时上限,超了直接失败。

首屏与交互:先定位再优化

首屏性能优化方案的顺序应该是:先测,再改,再回归。三项指标够用:FCP、LCP、INP。

小程序侧的常见问题是 setData 过大。一次 setData 传整个列表对象,渲染层要重建整棵树。改成按 key 增量更新,长列表用分页加虚拟列表,帧率立刻不一样。

图片是第二个大头。列表页用固定尺寸加懒加载,格式优先 WebP,头像类走 CDN 裁切参数,不要在前端缩放。

交互侧注意两件事:点击反馈要有,哪怕只是骨架屏或按钮态,用户感知的"快"很大程度来自反馈;另外避免在主线程做同步计算,复杂排序和格式化挪到 worker 或服务端。

一套代码多端用,差异全塞进适配层

分层这样切:业务层只依赖接口和数据类型,不 import 任何平台 API;适配层管登录、支付、存储、路由、埋点、分享,每端一份实现,接口签名统一;渲染层能复用组件就复用,平台特有交互(如小程序的原生导航)单独封装。

适配层用依赖注入而不是条件编译。条件编译在代码里留一堆 if,三个月后没人敢动;依赖注入在启动时注入实现,业务层完全无感。

包体差异要提前算:小程序的 2MB 主包限制决定了哪些能力必须放分包,APP 的热更新策略决定了哪些逻辑放到远端。这两条约束要在做技术方案时就写进去。

选型和协作成本

跨端框架的选择,比的不是特性列表,是三件事:出问题时能不能定位到原生层、社区组件是否还在维护、团队里有没有人真踩过坑。

协作成本上,三条规则能省很多事:接口类型由后端契约生成,不手写;组件库统一到一套,禁止各业务线自己封装弹窗;提交前跑 lint 和单测,CI 里加体积与性能基线检查。

锐智互动软件品牌隶属于北京锐智互动网络科技有限公司,上海设有分支机构上海锐智开高数字科技有限公司,具备小程序、APP、网页系统定制开发能力,依托AI大模型、物联网、数据管理能力,面向多行业做定制开发,可服务北京、上海、广州、深圳、长三角、珠三角及全国城市。

可直接抄的工程清单

· 构建:路由分包、依赖外置、持久化缓存、体积门禁 · 监控:FCP/LCP/INP 上报、错误聚合、慢接口 Top20 · 灰度:按用户 ID 哈希分桶,支持一键回滚 · 多端:适配层接口清单、平台差异登记表 · 发布:版本号与后端接口版本绑定,避免前端先上线

前端工程化做到这一步,多端复用才不会变成三套代码各自维护。

FAQ

Q1:小团队有必要一上来就做跨端框架吗?A:看渠道。只有一个渠道,用原生或单端框架更省心;两个以上渠道且迭代节奏一致,跨端才划算。差异极大的场景(如强依赖原生能力的工具类 APP)不要硬套。

Q2:主包 2MB 限制怎么突破?A:突破不了,只能分包。把非首屏业务全部下沉到分包,主包只留首页、登录和公共组件,配合分包预下载,用户几乎感知不到加载。

Q3:性能基线怎么定才不会被无视?A:接到 CI 里,超阈值让流水线失败。写在文档里的指标没人看,卡住发版才会被认真对待。