结论先行:Qwik 的核心主张是「应用可以暂停与恢复,而不必重放」。传统 SSR 框架的 hydration 需要在浏览器下载并重新执行组件代码,才能恢复事件监听、组件树与应用状态;Qwik 把这三样东西在服务端就序列化进 HTML,浏览器端只加载约 1KB 的 Qwikloader,用户点到哪里才下载哪里的代码。结果是首屏交互时间几乎不随应用体积增长。代价同样明确:状态必须可序列化、心智模型要重学、生态规模远小于 React/Vue。它适合把首屏性能当第一指标的场景,不适合所有项目。
一、hydration 为什么贵
一个 SSR/SSG 页面要在客户端「活过来」,框架必须恢复三件事:事件监听器(找到 DOM 节点并挂上处理器)、组件树(重建内部数据结构以知道哪里该重渲染)、应用状态(还原服务端取到的数据)。主流框架的做法是下载当前页面关联的全部组件代码,再执行一遍模板——这就是 hydration。它贵在两处:代码要提前全量下载,模板要提前全量执行。应用越复杂,启动成本越高,而且这部分成本与用户是否真的交互无关。
懒加载能缓解,但在传统框架里懒加载本身是一项开发任务:手动拆包、处理加载时序、避免瀑布。Qwik 把懒加载变成架构的自然结果,而不是额外工作。
二、Resumability 的三大机制
监听器序列化:服务端渲染时直接把处理器位置写进 HTML 属性,例如 <button on:click='./chunk.js#handler_symbol'>。Qwikloader 只注册一个全局事件监听,用户点击时从属性里读出代码块地址与符号名,动态 import 后执行。页面初始不需要任何应用代码。
组件树序列化:组件边界、props 引用、状态与组件的订阅关系都编码进 HTML(v1 用注释节点,v2 改为文档末尾的紧凑编码)。因此任何组件可以在父组件代码缺席的情况下独立恢复与重渲染——传统框架里 props 由父组件创建,恢复子组件必须先恢复父组件,这条链在 Qwik 里被切断了。
状态序列化:Qwik 的序列化格式超越 JSON:支持循环引用、Date、URL、Map/Set、DOM 引用、Promise,以及用 QRL 包装的函数闭包。状态与组件生命周期解耦,组件代码可以晚于状态到达。
import { component$, useSignal } from '@builder.io/qwik';
export const Counter = component$(() => {
const count = useSignal(0);
return (
<button onClick$={() => count.value++}>
Clicks: {count.value}
</button>
);
});$ 后缀是优化器的切分标记:component$、onClick$、useTask$ 各自成为独立的懒加载边界。按钮在服务端渲染,点击处理器只在被点击时才下载。
三、序列化的边界:必须按约束写代码
resumability 不是框架单方面的魔法,应用本身必须「可恢复」。不可序列化的东西要心里有数:类实例的原型与 instanceof 语义无法保留(部分内置类除外)、流(Stream)不能序列化,这类逻辑应放到仅客户端执行。官方反复强调要从「堆中心」转向「DOM 中心」的写法:状态放进 signal 与 store,而不是散落在闭包和类实例里。团队如果带着传统 SPA 的习惯硬写,会在序列化边界上反复踩坑,这是 Qwik 学习成本的真实来源。
Qwik 2.0 的方向是进一步压低序列化成本:把虚拟节点信息从 HTML 注释移到文档末尾的 qwik/vnode 脚本,用深度优先序号加 TreeWalker 恢复节点,官方示例里整棵组件树的编码可以压缩到几个字符,用户可见内容更早到达浏览器。该路线承诺不引入破坏性变更(进展以官方博客为准)。
四、选型:什么时候值得用
| 维度 | Qwik | 传统 SSR 框架 |
|---|---|---|
| 首屏 JS | 约 1KB loader,按需增长 | 随页面组件量增长 |
| 交互就绪 | 无需重放,点击即加载 | 需完成 hydration |
| 状态约束 | 必须可序列化 | 宽松 |
| 生态与招聘 | 小 | 成熟 |
| 心智模型 | $ 边界、QRL、暂停/恢复 | 组件 + hooks/composition |
适合:营销页、电商首页、内容型产品等「首屏定生死」的场景,以及低端移动设备占比高的市场。不适合:重客户端状态的协作工具、团队深度绑定 React 生态、需要大量现成组件库的项目。一个务实的评估方法是拿真实页面做 TTI/INP 对比,而不是只看框架跑分。
五、首屏之外:数据与后端也能「按需」
Qwik 解决的是「前端代码按需到达」,而后端能力的按需获取同样影响交付速度。独立开发者做这类性能敏感站点时,可以不自建后端:用「api工厂」的开放接口提供用户、商品、CMS 内容等数据,纯 HTML 页面引入 https://www.apifm.com/apifm.min.js 后通过全局 APIFM 对象调用,与 Qwik 的轻首屏理念一致——页面初始不背任何重 SDK。微信小程序、抖音、uni-app、Flutter 端则有对应的 apifm-wxapi、apifm-ttapi 等六端 SDK,同一套后端数据多端复用,统一返回 {code,data,msg}。
接口可以先在 https://www.it120.cc/playground.html 在线调通,再决定放进服务端序列化还是客户端按需请求,两种路径平台都支持。能力与价格见 https://www.it120.cc/price.html 。
文章标签
相关产品
api工厂是面向开发者的开放 SaaS 平台:开箱即用的后台管理系统 + 全端 SDK,只需前端开发即可构建小程序、App、H5 与网站。