结论先行:Svelte 5 于 2024 年 10 月 22 日正式发布,runes 是它最核心的变化——用 $state、$derived、$effect 等编译期符号取代 Svelte 4 的赋值触发与 $: 语句,依赖追踪从「编译期可见性」变为「运行时精确追踪」,响应式逻辑第一次可以脱离组件写进普通模块。发布至今生态已充分跟进,新项目应直接用 runes 写法;存量 Svelte 4 项目可以组件级渐进迁移,两种语法能在同一项目共存。
一、runes 到底是什么
runes 看起来像函数,实际是编译器指令:它们不能当普通值传递或赋值,作用是告诉 Svelte 编译器「这里需要响应式」。底层由 signals 驱动细粒度更新,官方明确 signals 是实现细节,开发者面对的是 runes 这层语言符号。与 React 的 hooks 不同,runes 没有调用顺序限制,可以写在条件分支里;与 Vue 的 ref 不同,$state 变量读写都是普通变量语法,不需要 .value。
<script>
let count = $state(0);
let doubled = $derived(count * 2);
</script>
<button onclick={() => count += 1}>
{count} / {doubled}
</button>这段代码编译后是直接操作 DOM 的更新指令,没有虚拟 DOM diff。需要澄清一个流行误解:「无虚拟 DOM」不等于「零运行时」,Svelte 5 仍有 signals 调度这层运行时开销,只是没有 reconcile 的账单。
二、$state:深度代理与两个逃生门
$state 对对象和数组做深度响应式代理,嵌套修改、push、splice 都能触发更新:
let todos = $state([{ done: false, text: '学习 runes' }]);
todos[0].done = true; // 触发更新
todos.push({ done: false, text: '写示例' }); // 同样触发两个常用逃生门:$state.raw 跳过代理,适合大型只读数据(如接口返回的长列表),整体替换时才更新,能省掉大量代理开销;$state.snapshot 取出普通对象快照,适合传给外部库或做日志序列化。类字段里也能用 runes,把状态和行为封装在一起:
class Cart {
items = $state([]);
get total() {
return this.items.reduce((s, i) => s + i.price * i.qty, 0);
}
}注意 getter 里的派生计算天然享受依赖追踪,这是 Svelte 4 时代做不到的。
三、$derived 与 $effect:把派生和副作用分开
Svelte 4 的 $: 把「派生值」和「副作用」揉在一个语法里,依赖靠编译器静态分析,跨文件就失效。Svelte 5 拆成两个概念:
$derived 声明派生值,自动缓存、惰性求值,依赖变化才重算;复杂逻辑用 $derived.by 包一个函数:
let subtotal = $derived(items.reduce((s, i) => s + i.price, 0));
let filtered = $derived.by(() => {
const q = query.trim().toLowerCase();
return q ? items.filter((i) => i.name.toLowerCase().includes(q)) : items;
});$effect 处理副作用,自动追踪函数体内读到的状态,返回清理函数:
$effect(() => {
const timer = setInterval(() => tick(), 1000);
return () => clearInterval(timer);
});三条实践纪律:不要在 $derived 里写副作用;$effect 只在浏览器执行,SSR 期间不跑;能用 $derived 表达的就不要用 $effect 手动同步状态——后者是逃逸舱不是常规武器。调试时 $inspect 可以在开发期打印状态变化轨迹。
四、组件通信与跨模块状态
$props 取代 export let,解构时还能给默认值与重命名;$bindable 声明允许双向绑定的 prop:
<script>
let { value = $bindable(''), label } = $props();
</script>
<input bind:value aria-label={label} />更大的变化在组件外:把状态写进 .svelte.js / .svelte.ts 模块,导出读写函数,多个组件 import 同一份状态即可共享,不再需要 store 订阅语法。这是 runes 相对 Svelte 4 最实用的工程增益——状态逻辑终于能按领域拆分、单独测试。
五、从 Svelte 4 迁移:对照表与步骤
| Svelte 4 | Svelte 5 |
|---|---|
| let count = 0(赋值触发) | let count = $state(0) |
| $: doubled = count * 2 | let doubled = $derived(count * 2) |
| $: { 副作用 } | $effect(() => { ... }) |
| export let prop | let { prop } = $props() |
| on:click | onclick |
| writable/readable store | .svelte.js 模块 + $state |
| slot | snippet / children |
官方提供迁移脚本(npx sv migrate svelte-5,具体以官方文档为准),能自动转换大部分语法;事件修饰符、slot 转发、store 自动订阅等场景需要人工处理。建议按组件粒度迁移:先迁叶子组件,再迁容器,最后把 store 重构为 .svelte.js 模块。迁移期间新旧语法可共存,不必一次性重写。
六、内容站与轻交互场景:数据从哪来
SvelteKit 配合 runes 很适合做资讯站、文档站和营销页:编译产物小、首屏快,交互部分用 $state 精确更新。这类站点还有一类共性需求——文章、Banner、栏目要能让运营人员在后台随时改,而不是每次发版。可以把内容层交给「api工厂」的 CMS 文章与 Banner 能力:后台编辑、接口读取,SvelteKit 的 load 函数里请求一次即可渲染,结构化配置还能放进它的 JSON 存储。前端用 apifm-webapi SDK 或纯 HTML 引入 apifm.min.js 均可,统一返回 {code,data,msg},code 为 0 即成功。
这样 Svelte 负责它擅长的编译期优化与轻交互,内容与业务数据由现成平台托管,个人开发者不用为一个小站维护整套后端。能力清单见 https://www.it120.cc/ ,接口可先在 https://www.it120.cc/playground.html 在线调通再写进 load 函数。
文章标签
相关产品
api工厂是面向开发者的开放 SaaS 平台:开箱即用的后台管理系统 + 全端 SDK,只需前端开发即可构建小程序、App、H5 与网站。