2024 年我们接过一个需求:同一个业务,要同时有网页版、微信小程序、Windows 桌面客户端。老板的原话是「一套代码,三端复用,省一半人力」。第一版我们确实这么干了:React 加一个跨端框架,桌面用 Electron 套壳,小程序编译过去,移动端直接跑 H5。上线三个月,三端都收到了「不好用」的反馈:桌面端安装包 160MB、开两个窗口内存吃到 1.3G;小程序主包超限,首屏要等两次分包加载;移动端在旧版 WebView 上白屏。
复盘时我们发现,问题不在「跨端」这个方向本身,而在「跨什么」。我们跨的是组件树和交互细节,而这两样恰恰是三端差异最大的部分;真正该共用的业务规则、数据模型、校验逻辑,反而被 UI 代码缠在一起,抽不出来。
这篇讲我们后来怎么重新划这条线:哪些代码进共享层,哪些必须分叉;桌面端在 Electron 和 Tauri 之间怎么选;WebView 壳和小程序有哪些绕不过去的限制。最后给一套能当场用的判断方法,而不是「跨端框架选型对比表」。
先算清楚三端到底差多少
「跨端」的收益等于「共用比例 × 维护年限」,成本等于「抽象层复杂度 × 差异处理次数」。所以第一步不是选框架,是列功能矩阵。
我们把当时的功能拆成 40 项,逐项标注三端是否需要、交互是否一致。结果大致是三堆:
这张表算完,结论就很清楚了:能共用的是「领域逻辑」,不是「界面」。如果强行把界面也共用,就会在每一端都写一堆 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 需要代码签名证书,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,都不会波及共享层。
真实踩的坑
三端跑了一年,下面这些现象基本覆盖了跨端项目的主要故障面。注意它们的共同点:大部分不是「框架的 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 之间选,本质是在「一致性与生态」和「体积与内存」之间选;移动端套壳要先确认真的需要原生能力;小程序的限制是硬的,只能按平台规则设计。
这八篇到这里就结束了。从仓库怎么组织,到产物怎么控制、性能怎么度量、组件怎么维护、线上怎么观测、大项目怎么划边界、风险怎么设防,再到多端怎么分叉——它们其实在回答同一个问题:当一个前端项目大到一个人装不下时,怎么把它切成能被不同人独立负责的小块,同时又不让这些小块重新粘成一团。答案不在某个工具里,在边界画得对不对。