2024 年我们接过一个需求:同一个业务,要同时有网页版、微信小程序、Windows 桌面客户端。老板的原话是「一套代码,三端复用,省一半人力」。第一版我们确实这么干了:React 加一个跨端框架,桌面用 Electron 套壳,小程序编译过去,移动端直接跑 H5。上线三个月,三端都收到了「不好用」的反馈:桌面端安装包 160MB、开两个窗口内存吃到 1.3G;小程序主包超限,首屏要等两次分包加载;移动端在旧版 WebView 上白屏。

复盘时我们发现,问题不在「跨端」这个方向本身,而在「跨什么」。我们跨的是组件树和交互细节,而这两样恰恰是三端差异最大的部分;真正该共用的业务规则、数据模型、校验逻辑,反而被 UI 代码缠在一起,抽不出来。

这篇讲我们后来怎么重新划这条线:哪些代码进共享层,哪些必须分叉;桌面端在 Electron 和 Tauri 之间怎么选;WebView 壳和小程序有哪些绕不过去的限制。最后给一套能当场用的判断方法,而不是「跨端框架选型对比表」。

先算清楚三端到底差多少

「跨端」的收益等于「共用比例 × 维护年限」,成本等于「抽象层复杂度 × 差异处理次数」。所以第一步不是选框架,是列功能矩阵。

我们把当时的功能拆成 40 项,逐项标注三端是否需要、交互是否一致。结果大致是三堆:

完全共用(约 45%)业务规则、数据模型、金额与日期计算、表单校验、接口调用与重试、权限判断、文案与国际化。
形态不同但逻辑相同(约 30%)列表、详情、搜索。数据一样,但桌面要支持右键和多选,移动要支持下拉刷新,小程序要用原生导航栏。
必须分叉(约 25%)文件导入导出、打印、蓝牙、扫码、推送、支付、窗口管理、离线缓存、自动更新。这些是平台能力,没有统一抽象可言。

这张表算完,结论就很清楚了:能共用的是「领域逻辑」,不是「界面」。如果强行把界面也共用,就会在每一端都写一堆 if (platform === ...),最后比分开写还难维护。

约束:为什么不能全用一套框架

约束实际情况对方案的影响
用户分布手机浏览器 55%,微信小程序 30%,桌面 15%移动端体验优先,桌面不能拖后腿
桌面能力要读写本地文件、调打印机、常驻托盘、自动更新必须原生壳,纯 Web 做不到
小程序限制无 DOM、包体积上限、请求域名白名单、审核周期共享代码不能碰浏览器 API,构建要能裁剪
团队8 名前端,没有 Rust 和客户端开发经验Tauri 的原生层要评估学习成本
分发桌面走企业官网下载,需要签名和自动更新签名证书、更新服务是必做项,不是可选项
合规小程序要过审,隐私协议和权限申请要逐项声明不能靠动态下发绕审核,功能要能静态检查

其中「团队没有 Rust 经验」这一条,直接决定了桌面端的第一版选 Electron。这不是技术优劣问题,是「谁能在半夜修崩溃」的问题。

桌面端:Electron 与 Tauri 的真实取舍

这两个经常被简化成「Tauri 包小、Electron 包大」,实际决策要复杂得多。版本假设:Electron 30 以上、Tauri 2.x。

Electron

是什么:自带 Chromium 和 Node.js 运行时,前端代码跑在一个完整的浏览器里,系统能力通过 Node 模块和主进程调用。

代价:安装包通常 80–160MB,空壳内存 200MB 起,多窗口更高;每个窗口一个渲染进程,泄漏会累积。好处是三端渲染一致性最好,生态成熟,签名、自动更新、崩溃收集都有现成方案。

Tauri

是什么:用系统自带的 WebView 渲染(Windows 是 WebView2,macOS 是 WKWebView,Linux 是 WebKitGTK),后端用 Rust,安装包通常 5–20MB,内存也低得多。

代价:三端 WebView 内核不同,CSS 和 JS 的兼容问题要自己踩;系统能力要写 Rust 或找插件;Windows 依赖 WebView2 运行时(Win10 以后多数自带,旧机器要装);签名、更新、崩溃收集的生态比 Electron 新。

我们最后的方案是「Electron 先上,Tauri 做下一版」:第一版用团队熟悉的技术把功能跑通,同时把「系统能力调用」全部收在一个适配层里,为后面的替换留口子。半年后 Tauri 版只替换了壳,业务代码一行没改——这正是适配层的价值。

如果现在重新选,且团队有人能写 Rust,我会直接选 Tauri。省下的安装包体积和内存对用户体验是实打实的,尤其是配置低的办公电脑。但要接受一个事实:Tauri 的「一套代码」只保证业务逻辑,不保证渲染一致,还是要在三个系统上各测一遍。

Windows 上 Tauri 依赖 WebView2。用户的机器如果没装运行时,应用会直接打不开,而不是降级。发布前要么检测并引导安装,要么打包固定版本的运行时,这一步别省。

签名与分发:桌面端最容易被低估的部分

网页上线只要推代码,桌面应用不行。用户下载的是一个二进制文件,操作系统会检查它的签名,没有签名或签名不受信任,就会弹出「未知开发者」的警告,很多人到这一步就放弃了。

Windows 需要代码签名证书,EV 证书还能减少 SmartScreen 的拦截;macOS 需要 Apple 开发者账号,做公证(notarization),否则新系统直接拒绝运行。证书有有效期,过期后新版本签不出来,自动更新会失败——我们遇到过一次,证书到期前没人注意,结果一周发不了版。

自动更新本身也是一套系统:更新包怎么差分、失败怎么回滚、用户正在使用时怎么提示、更新后本地配置会不会被覆盖。我们踩过的坑是「更新把用户的自定义配置重置了」,原因是新版本把配置文件路径改了,旧文件没迁移。这类问题在网页端不存在,在桌面端是常态。

移动端:WebView 壳不是「套上就完事」

移动端我们用的是原生壳加 WebView,主要为了相机、推送和离线能力。这条路能走通,但坑很集中:

内核版本差异。iOS 的 WKWebView 跟系统版本走,Android 的 WebView 可以被厂商替换,也能被用户更新。同一份代码,在旧内核上可能不支持某些 ES 语法、CSS 属性或 API。构建 target 要按「最旧的内核」定,而不是按开发机。

白屏。最常见的原因是 JS 报错阻断了后续执行,而 WebView 默认不显示错误。必须接入错误监控,并且给壳加一个「加载超时兜底页」,否则用户只能看到一片白。

缓存与更新。WebView 会缓存 JS 和 HTML,发版后用户可能还在跑旧代码。要么用带 hash 的文件名加不缓存 HTML,要么用离线包机制并做好版本校验。我们有过一次「用户反馈 bug 已修但还在复现」,查了半天是缓存。

键盘与滚动。键盘弹起时页面高度变化,固定定位的按钮会被顶到屏幕外;iOS 的橡皮筋滚动、Android 的 resize 行为都不一样。这些只能在真机上测,模拟器基本测不出来。

返回键与路由。Android 的物理返回键要映射到前端路由的返回,否则一按就退出应用。这个映射要在壳里做,前端路由库不一定支持。

如果不需要相机、蓝牙、推送这些能力,纯 H5 加 PWA 就够了,别为了「有个 App」去套壳。套壳带来的审核、签名、更新、双端适配成本,远高于它带来的那点「图标在桌面上」的体验。

小程序:限制是硬的,不是工程能绕过的

小程序最像「另一个平台」,而不是「另一个浏览器」。几条硬限制必须先接受:

没有 DOM 和 BOM。没有 window、document,不能直接操作节点,逻辑层和视图层是分开的,跨层通信有开销。任何依赖 DOM 的库都用不了,包括一部分图表库和富文本库。

包体积上限。主包有大小限制,整包要靠分包。具体数值近两年调整过(主包 2MB,整包上限有 20MB 与 30MB 的说法,以微信官方最新文档为准,待确认)。打包时要把共享层里「这一端用不到」的代码裁掉,否则主包很容易超。

网络白名单。请求域名要在后台配置,不能随便请求第三方接口。本地开发要用开发者工具关掉校验,但上线前必须配齐。

不能动态执行代码。eval、new Function 被禁,很多模板引擎和表达式引擎直接失效。

审核。功能变更要过审,审核周期不可控。用「动态下发页面」绕审核是有风险的,轻则驳回,重则封禁。

登录与身份。拿到的不是普通 cookie 会话,而是 openid 体系,和 Web 端的账号要打通,通常需要后端做一次绑定。

跨端框架(Taro、uni-app 这类)能帮你把 JSX 编译成小程序模板,但编译产物和原生写法仍有差异,复杂组件经常要「这一端单独写」。我们的经验是:小程序端保留 20% 到 30% 的独立实现,不要追求 100% 复用。

重新划线:共享什么,分叉什么

第二版我们只共享「不依赖任何平台」的代码,结构如下。

// packages/core:纯 TypeScript,不 import 任何 DOM/框架/平台 API
export interface Order {
  id: string;
  amount: number;
  status: "pending" | "paid" | "closed";
}

export function canCancel(order: Order, now: Date): boolean {
  if (order.status !== "pending") return false;
  // 规则只写一次,三端行为一致
  return now.getTime() - Date.parse(order.createdAt) < 30 * 60 * 1000;
}

// packages/platform:每端实现同一组接口
export interface Platform {
  readFile(path: string): Promise<string>;
  notify(message: string): Promise<void>;
  getDeviceId(): string;
}

共享层有一条铁律:不能 import 任何平台相关的东西。我们用 ESLint 禁止它引用 window、document、wx、electron,并在 CI 里用一个 Node 环境跑一遍单测——能跑通,说明它确实和环境无关。

平台能力统一走适配层:桌面端用 Node 或 Rust 实现,移动端用 JSBridge,小程序用 wx API。业务代码只调接口,不关心背后是谁。这样换壳、加端、修某一端的 bug,都不会波及共享层。

多端代码的分层
各端界面桌面窗口与右键菜单、移动触摸交互、小程序原生导航,各自实现。
平台适配层文件、通知、支付、扫码、存储。每端一套实现,接口一致。
共享领域层数据模型、业务规则、校验、状态机。纯 TypeScript,可在 Node 里单测。
共享基础层请求封装、日期与金额、国际化、日志。不依赖 DOM。

真实踩的坑

三端跑了一年,下面这些现象基本覆盖了跨端项目的主要故障面。注意它们的共同点:大部分不是「框架的 bug」,而是「平台差异没有被显式处理」。

现象真实原因第一步查什么
小程序编译报 document is not defined共享包间接依赖了 DOM 或浏览器 API看共享包的 import 链;在 Node 里直接 import 一次
桌面安装包 160MB,用户不愿下Electron 打包未裁剪,带了多架构、语言包和调试符号看 asar 内容构成、locales 目录、是否打了多 arch
桌面端开两个窗口内存 1G 以上每个窗口一个渲染进程,页面里有泄漏或大图缓存按进程看内存;对比单窗口与多窗口
Tauri 版在部分 Windows 机器白屏WebView2 运行时缺失或版本过低查系统里 WebView2 的版本;看启动日志
移动端发版后用户还在旧版WebView 缓存了 HTML 或旧 JS看响应头缓存策略;确认 HTML 是否被缓存
小程序主包超限共享层全量打入,图片和字体没走 CDN看构建产物的依赖分析;确认分包策略
键盘弹起遮住输入框WebView 的 resize 行为与固定定位冲突真机上看 viewport 高度变化与元素位置
桌面自动更新失败签名证书过期,或更新包与当前架构不匹配查证书有效期;看更新日志与下载地址
三端同一个订单显示不同金额金额计算在各自端重写了一遍,精度处理不一致查金额计算是否在共享层;对比三端输入输出

最后一行特别值得警惕。跨端项目最容易出现的不是崩溃,而是「三端行为悄悄不一致」:同一个优惠券在桌面能用、在小程序不能用;同一个日期在 iOS 和 Android 差一天。这类问题不会报错,只会让客服收到零散的投诉。解决办法只有一个:把规则收进共享层,并且用同一组测试用例跑三端。

边界与代价:什么时候不该跨端

只有一端,别跨。为了「以后可能有其他端」提前抽象,是最常见的过度设计。等真的有第二端再抽,成本更低。

三端功能差异超过四成,别追求一套代码。抽象层会变成一堆条件分支,维护成本超过分开写。共享领域层,界面各写各的,反而更省。

团队少于五人,别自研跨端方案。用成熟的跨端框架或直接分端开发。自研抽象层的隐性成本,通常在第二个端上线后才显现。

桌面用户占比很低,先做 PWA。可安装、可离线、有推送,成本远低于维护一个 Electron 应用。等用户真的需要本地文件和系统集成,再上壳。

小程序不是「顺手做一个」。它有自己的审核、包体、网络和身份体系,至少按「半个平台」来排期,别按「改一改就能上」估工。

还有一个长期代价:三端的测试矩阵会成倍扩张。桌面要测 Windows 和 macOS,移动要测 iOS 和 Android 的不同内核,小程序要测真机和开发者工具。没有自动化真机测试的话,每次发版的人力成本会悄悄翻倍。

今天就能动手的五件事

一、列一张功能矩阵。把现有功能拆成 30 到 40 项,逐项标注「哪些端需要、交互是否一致」。共用比例低于一半,就别急着上跨端框架。

二、测共享层纯不纯。在一个纯 Node 环境里 import 你的共享包,跑一遍核心函数。报 document is not defined 的,都是未来小程序端的雷。

三、打两个空壳对比。用 Electron 和 Tauri 各打一个只显示「Hello」的应用,记录安装包体积、冷启动时间、空载内存。数字比任何选型文章都直观。

四、在真机上验证缓存和键盘。用一台旧 Android 手机,发一次版,看是否立刻生效;再点输入框,看键盘弹起时按钮是否还在可视区。模拟器会骗你。

五、检查签名和更新链路。确认桌面端的签名证书有效期、自动更新的下载地址、失败回滚策略。最好手动制造一次更新失败,看应用会不会变砖。

小结

多端架构的关键不是「用哪个框架」,而是「共享领域逻辑,分叉平台交互」。桌面端在 Electron 与 Tauri 之间选,本质是在「一致性与生态」和「体积与内存」之间选;移动端套壳要先确认真的需要原生能力;小程序的限制是硬的,只能按平台规则设计。

这八篇到这里就结束了。从仓库怎么组织,到产物怎么控制、性能怎么度量、组件怎么维护、线上怎么观测、大项目怎么划边界、风险怎么设防,再到多端怎么分叉——它们其实在回答同一个问题:当一个前端项目大到一个人装不下时,怎么把它切成能被不同人独立负责的小块,同时又不让这些小块重新粘成一团。答案不在某个工具里,在边界画得对不对。