90%以上业务代码复用依赖主动隔离平台差异、分层抽象和条件编译下沉至最小单元;需在API调用前做运行时判断、资源按平台分离、配置统一收口、组件/Hook剥离强依赖、原生能力接口抽象+运行时加载,并严守mixins与UTS边界。

90% 以上的业务代码复用不是靠“写一遍就自动跑通所有端”,而是靠主动隔离平台差异、分层抽象、条件编译下沉到最小单元——不满足这三点,复用率连 50% 都难稳住。
平台 API 差异必须在调用前判断
很多人把整块逻辑包在 #ifdef MP-WEIXIN 里,结果 App 端漏掉初始化、小程序端误执行原生插件。真正安全的做法是:API 调用前加运行时判断,而不是编译期粗粒度包裹。
-
uni.chooseImage在小程序返回tempFilePaths,App 端(尤其 iOS)可能返回localFilePath或完整file://路径,直接取res.tempFilePaths[0]在 App 上会报undefined is not an object -
uni.getSystemInfoSync()返回字段不一致:App 多出model、platform,小程序带SDKVersion,字段访问前必须先in判断或用可选链 - 分享、定位、蓝牙等能力,优先用
uni.canIUse('showShareMenu')做能力探测,比硬写平台判断更健壮
路径、资源、样式要按平台分离
图片、字体、配置文件这类静态资源,不能共用一个路径然后靠条件编译删掉某端代码——构建时删的是整个代码块,但资源引用还在,导致 H5 加载失败、App 找不到图标。
- 图片资源用双后缀:@/static/img/logo@mp.png 和 @/static/img/logo@app.png,uni-app 构建时自动识别并替换
- CSS 中避免
/* #ifdef H5 */整块注释样式,改用 class 控制显隐,比如.btn--h5-only+process.env.UNI_PLATFORM === 'h5'动态加类 - 路由配置、接口 base URL、mock 开关这些运行时配置,统一收口到
env.config.js,按UNI_PLATFORM导出不同对象,而非分散在各页面里写死
组件和 Hook 必须剥离平台强依赖
一个叫 ShareButton 的组件,如果在 onLoad 里直接调 uni.showShareMenu,它就不可能在 App 端复用——App 不支持这个 API,且该方法在小程序是同步,在 App 是异步回调,钩子执行顺序一乱就出竞态。
- 把平台逻辑抽离成注入函数:父页面根据平台传
shareHandler: () => { ... },子组件只负责触发,不关心实现 - 自定义 Hook 如
useListRequest,内部不做平台判断,只封装请求流程;平台差异交给外部传入的fetchFn处理 - 原生能力(如扫码、蓝牙)必须走「接口抽象 + 运行时加载」:定义统一函数名如
scanCode(),内部用process.env.UNI_PLATFORM分支加载对应实现,其他平台直接return Promise.reject(...)
混入(mixins)和 UTS 模块要严守边界
混入不是万能胶,它是复用的加速器,也是隐蔽的污染源。很多团队复用率卡在 70%,问题就出在混入里偷偷写了平台专属逻辑,或者 data 字段被组件覆盖后行为失真。
-
mixins必须是数组:mixins: [authMixin],写成mixins: authMixin直接报错 - 混入里的
data()和组件data()同名字段,以组件定义为准——想让混入控制初始值,就别在组件里重复声明loading、page这类字段 - UTS 编写的原生模块,只能在
app-plus下运行,不能出现在通用业务组件的import链里,否则小程序编译会失败;要用if (uni.getSystemInfoSync().platform === 'ios')运行时判断再requireNativePlugin
复用率能不能上 90%,关键不在你写了多少通用代码,而在于你有没有把每一个 uni.xxx 调用、每一处路径引用、每一个生命周期钩子里的平台假设,都拆解成可验证、可替换、可兜底的最小单元。越早接受“跨端不是免费的”,越容易写出真正高复用的代码。











