1 / 4概念
State and Data
Svelte 把工作的重心从运行时搬到编译期:组件被编译成直接操作 DOM 的代码,更新只落在真正变化的节点上。判断标准不是会不会写 $state,而是能否说清一次赋值之后,编译器生成了哪些更新语句。
1 概念
1.1 一句话定义
Svelte 是一个编译器。它把组件源码变成创建与更新 DOM 的函数,没有虚拟 DOM,也没有运行时协调。响应式由赋值或显式的 runes 触发,依赖在编译期或运行时被精确记录。
1.2 它解决什么问题
- 减小运行时:框架的大部分逻辑在编译期完成,产物只有少量辅助函数。
- 精确定位更新:编译期知道哪个节点依赖哪个变量,更新直接落在节点上。
- 少写样板:模板与逻辑同文件,响应式语法接近普通 JavaScript。
- 全栈约定:SvelteKit 提供路由、数据加载、表单动作与部署适配。
1.3 不属于本页的内容
| 主题 | 去哪 |
|---|---|
| React 的协调与状态模型 | Rendering and Reconciliation、State and Data |
| Vue 的代理响应式 | Reactivity、Application Architecture |
| 浏览器 DOM 与事件 | Browser Environment |
| 打包与适配器细节 | Toolchain |
| 服务端接口设计 | Backend Frameworks |
1.4 关键术语
| 术语 | 含义 | 容易混淆的点 |
|---|---|---|
| 编译期 | 构建时把组件转成函数 | 不是运行时框架 |
| runes | 以 $ 开头的响应式原语 | 不是普通变量 |
$state | 响应式状态 | 深层代理,不是浅层 |
$derived | 派生值 | 不是副作用 |
$effect | 副作用 | 只在浏览器运行 |
$props | 接收父组件数据 | 可声明默认值 |
| legacy 模式 | 赋值触发更新的旧写法 | 与 runes 不能混用 |
| store | 可在组件外订阅的容器 | runes 出现前的共享方式 |
| keyed each | 带 key 的列表块 | 决定节点复用 |
| SvelteKit | 官方全栈框架 | 不是 Svelte 本体 |
load | 路由级数据加载 | 服务端与客户端各有一版 |
2 机制
2.1 心智模型
编译期做三件事:收集依赖、生成创建代码、生成更新代码。运行时只做两件事:读值、写节点。所以「更新」是一段段具体的赋值语句,而不是整棵树的比较。
2.2 机制拆解
- 编译产物:每个组件变成一个模块,导出创建函数与更新片段;模板里的动态节点被打上标记。
- 赋值触发:legacy 模式下
count += 1被编译器改写为赋值加调度;原地push不会触发,需要重新赋值。 - runes 模式:
$state返回一个深层代理,读写都会被记录;$derived惰性求值并按依赖失效。 - 副作用时机:
$effect在挂载后运行,依赖变化后重跑;$effect.pre在 DOM 更新前运行。 - 列表复用:
each带 key 时按 key 复用节点,不带 key 时按下标,状态会错位。 - SvelteKit 加载:
+page.ts在两端都能跑,+page.server.ts只在服务端跑;数据随页面序列化。 - 水合:服务端输出 HTML,客户端接管事件与状态,首帧必须与 HTML 一致。
2.3 完整枚举
runes 的完整集合:
| Rune | 作用 |
|---|---|
$state | 声明响应式状态 |
$state.raw | 浅层状态,整体替换才更新 |
$state.snapshot | 取非代理快照 |
$derived | 声明派生值 |
$derived.by | 用函数体声明派生值 |
$effect | 声明副作用,依赖自动收集 |
$effect.pre | DOM 更新前执行的副作用 |
$props | 声明组件入参 |
$bindable | 标记可双向绑定的 prop |
$inspect | 开发期打印依赖变化 |
legacy 与 runes 的对照:
| 事项 | legacy | runes |
|---|---|---|
| 声明状态 | let count = 0 | let count = $state(0) |
| 触发更新 | 赋值 | 读代理即追踪 |
| 派生 | $: doubled = count * 2 | $derived(count * 2) |
| 副作用 | $: { ... } | $effect(() => { ... }) |
| 入参 | export let name | let {name} = $props() |
| 共享状态 | store | runes 加模块级 $state |
SvelteKit 的八个文件约定:
| 文件 | 作用 |
|---|---|
+page.svelte | 页面组件 |
+page.ts | 两端都执行的数据加载 |
+page.server.ts | 只在服务端执行的数据加载 |
+layout.svelte | 布局组件 |
+layout.server.ts | 布局级服务端数据 |
+error.svelte | 错误页 |
+server.ts | 接口端点 |
hooks.server.ts | 服务端钩子,鉴权等 |
四种渲染行为:
| 行为 | 首屏 | 适用 |
|---|---|---|
| SSR 加水合 | 服务端 HTML | 大多数页面 |
| 仅客户端 | 空白加脚本 | 后台系统 |
| 预渲染 | 构建时 HTML | 静态内容 |
| 流式渲染 | 分块输出 | 慢数据页面 |
2.4 关键数字与量级
| 指标 | 量级 | 说明 |
|---|---|---|
| 运行时辅助代码 | 几 KB | 按组件数增长缓慢 |
| 编译产物 | 与模板节点数成正比 | 大组件可拆分 |
| 更新成本 | 与变化节点数成正比 | 不与整树规模相关 |
| 水合成本 | 与 DOM 节点数成正比 | 大列表分页 |
| 构建时间 | 与组件数成正比 | 编译型框架的主要成本 |
3 实践
3.1 最小示例
runes 下的计数器:状态、派生、副作用各出现一次,副作用依赖被自动收集。
<script lang="ts">
let count = $state(0);
let doubled = $derived(count * 2);
$effect(() => {
console.log('count is', count);
});
</script>
<button onclick={() => count += 1}>
count: {count}, doubled: {doubled}
</button>
追踪:点击后 count 加一,代理记录到写入,doubled 失效,$effect 的依赖包含 count,因此重新执行。编译器为按钮文本生成两段更新语句,只写变化的那两个文本节点,不会重建按钮。
对照 legacy 写法:let count = 0 需要靠赋值改写来触发,$: doubled = count * 2 由编译器生成依赖;两种写法不能在同一组件里混用。
3.2 常用操作与参数
| 操作 | 写法 | 说明 |
|---|---|---|
| 声明状态 | let x = $state(0) | 对象会被深层代理 |
| 大对象浅层 | let buf = $state.raw(big) | 整体替换才更新 |
| 派生 | let y = $derived(fn(x)) | 不要在里面写副作用 |
| 取快照 | $state.snapshot(obj) | 传给外部库 |
| 组件入参 | let {title = 'hi'} = $props() | 解构带默认值 |
| 双向绑定 | let {value = $bindable()} = $props() | 子组件可回写 |
| 列表 | {#each items as item (item.id)} | 带 key 复用 |
| 加载数据 | +page.server.ts 的 load | 只在服务端 |
3.3 标准流程
- 新组件一律用 runes,不要与 legacy 混写。
- 状态尽量窄:只放真正变化的字段,其余用
$derived。 - 副作用只做外部同步(订阅、日志、第三方实例),清理写在返回函数里。
- 列表一律带 key,key 用稳定 id。
- 数据加载放
+page.server.ts,密钥与数据库访问不进入客户端分块。 - 需要 SEO 或首屏可见的页面开启 SSR,交互密集页面可以关掉。
3.4 与相邻技术的组合
- 浏览器:编译产物直接操作 DOM,事件用
onclick这样的属性写法。 - 工具链:
vite-plugin-svelte负责编译,产物按路由分包。 - SvelteKit:适配器把同一份应用部署到 Node、静态托管或边缘运行时。
- 状态:模块级
$state可以替代 store,但 SSR 下模块状态会跨请求共享,要谨慎。 - 类型系统:
lang="ts"让模板中的表达式也参与类型检查。
3.5 选型维度
| 维度 | 取值 | 影响 |
|---|---|---|
| 响应式 | runes / legacy | 写法与迁移成本 |
| 渲染 | SSR / CSR / 预渲染 | 首屏与 SEO |
| 数据 | load / 组件内取数 | 水合与缓存 |
| 状态共享 | 模块 $state / store | SSR 安全与测试 |
| 部署 | Node / 静态 / 边缘 | 适配器选择 |
3.6 决策规则
- 新项目用 runes;旧项目先迁移组件再统一。
- 需要跨组件共享又要求 SSR 安全时,把状态放在
load返回的数据里。 - 第三方实例(图表、编辑器)放进普通变量,不要放进深层代理。
- 大数组用
$state.raw,改完整体替换。 - 只有需要改 DOM 或订阅外部源时才用
$effect。
3.7 替代方案对比
| 方案 | 优势 | 代价 | 适用 |
|---|---|---|---|
| Svelte 加 SvelteKit | 体积小、写法短 | 生态与招人面窄 | 内容站、小团队 |
| React | 生态最大 | 运行时与样板 | 大型应用 |
| Vue | 渐进式、上手快 | 代理开销 | 中后台 |
| 纯 Web Components | 无框架 | 状态与路由要自建 | 嵌入式组件 |
3.8 何时不该用
- 不要为一次性页面引入全栈框架。
- 不要在
$effect里写业务主流程,副作用应可省略。 - 不要把模块级
$state当请求级状态,SSR 会串数据。 - 不要混用 legacy 与 runes,编译器会直接报错。
- 不要给列表省 key,状态错位比性能损失更贵。
4 边界
4.1 典型故障
| 症状 | 根因 | 处理 |
|---|---|---|
数组 push 后界面不动 | legacy 模式只认赋值 | 重新赋值或改 runes |
| 组件编译报错 | legacy 与 runes 混用 | 统一到一种模式 |
$effect 无限循环 | 副作用里写了它依赖的状态 | 拆分或加条件 |
服务端报 window 未定义 | 顶层访问浏览器 API | 移到 onMount |
| 水合告警 | 首帧与服务端 HTML 不同 | 首帧不读随机值 |
| 列表项状态错位 | each 没带 key | 用稳定 id |
| 第三方实例行为异常 | 被深层代理 | 用普通变量 |
| 部署后分块 404 | 旧产物被清理 | 保留上一版本 |
4.2 反模式
| 做法 | 后果 | 替代 |
|---|---|---|
| 混用两种模式 | 编译失败 | 统一 runes |
在 $effect 里写状态 | 循环触发 | 用 $derived |
| 模块级可变状态 | SSR 跨请求污染 | 请求级数据 |
| 省略列表 key | 状态错位 | 稳定 id |
| 深层代理大数组 | 访问变慢 | $state.raw |
4.3 可观测信号
编译产物体积、每次更新的 DOM 操作数、水合告警数、$effect 执行次数、首屏可交互时间、适配器构建耗时。
4.4 安全 / 性能 / 一致性边界
- 注入边界:
{@html}会直接写入 HTML,未净化的内容就是 XSS 入口。 - 服务端边界:
+page.server.ts里的代码不会进入客户端分块,密钥只能放这里。 - 性能边界:升级是编译期的,运行时只做局部写入;瓶颈通常在首屏体积与水合。
- 一致性边界:服务端与客户端必须用同一份数据渲染,模块级状态会让并发请求互相污染。