很多前端项目的复杂性不是来自页面数量,而是来自状态之间的关系:搜索框改变了列表,列表又影响统计数字,用户勾选一条记录后,多个组件必须同步更新。Svelte 5 的 Runes 提供了一套明确的响应式语法,让这些依赖能够直接写在普通 JavaScript 和组件逻辑中。
本文以任务清单为例,介绍 $state、$derived、$effect 的分工,比较“计算数据”与“同步外部系统”的差异,并进一步讨论组件拆分、持久化、异步请求和性能边界。
一、Runes 和旧式响应式写法有什么不同
Svelte 5 的 $state、$derived、$effect 是由 Svelte 编译器识别的特殊语法,并不是从某个 npm 包导入的普通函数。它们能够在 Svelte 组件中使用,也可在适当的 .svelte.js 或 .svelte.ts 模块中组织可复用的响应式逻辑。
旧项目中常见的 $: 声明与 store 仍有使用场景,但在 Runes 模式下,派生状态应优先使用 $derived,副作用应使用 $effect。不要把所有状态变化都塞进同一个副作用函数,否则很容易形成重复更新。
先设计清单的基本结构:
<div id="https://github.com/tiktokwuyu-ux/TIKTOK_baike/commit/9c2fe6293eaca83e05bb167fe5872d2caf360156">
<section class="task-board" aria-labelledby="task-title">
<header><h1 id="task-title">我的任务</h1></header>
<div data-task-toolbar></div>
<ul data-task-items></ul>
</section>
</div>
二、使用 $state 创建可变状态
$state 创建响应式变量。对于普通数组和对象,Svelte 能追踪它们的深层属性变化,因此很多操作不需要显式复制整个数组再赋值。
<script lang="ts">
type Task = { id: string; title: string; completed: boolean };
let tasks = $state<Task[]>([
{ id: 't1', title: '完善首页布局', completed: false },
{ id: 't2', title: '检查接口错误处理', completed: true }
]);
let query = $state('');
function addTask(title: string) {
const normalized = title.trim();
if (!normalized) return;
tasks.push({
id: crypto.randomUUID(),
title: normalized,
completed: false
});
}
</script>
tasks.push() 会触发相关依赖更新,这与“只能替换数组才能更新视图”的旧式认知不同。尽管如此,仍然应保持清晰的数据所有权:如果多个组件随意修改同一份共享对象,排查问题会比局部状态困难。
<div id="https://github.com/tiktokwuyu-ux/TIKTOK_baike/commit/b0eb8a005140205570f014199458d30b19918b83" class="task-input-zone">
<label for="new-task">新增任务</label>
<input id="new-task" name="title" autocomplete="off">
<button type="button" data-create-task>添加</button>
</div>
三、用 $derived 表达依赖关系
完成数、剩余数和筛选列表都可以从 tasks 推导出来。派生状态不应保存一份需要手动同步的数据副本。
<script lang="ts">
let finishedCount = $derived(tasks.filter(task => task.completed).length);
let remainingCount = $derived(tasks.length - finishedCount);
let visibleTasks = $derived.by(() => {
const normalized = query.trim().toLocaleLowerCase('zh-CN');
return tasks.filter(task =>
task.title.toLocaleLowerCase('zh-CN').includes(normalized)
);
});
</script>
其中 $derived.by 适合多语句计算,它与 $derived(expression) 的目标一致:根据依赖计算值,不在计算过程中修改其他状态。如果派生函数同时发送网络请求、写入本地存储,就会把计算与副作用混在一起。
<div id="https://github.com/tiktokwuyu-ux/TIKTOK_baike/commit/8aaa6bfe573acd152800a613a5da26c06ad8ee62">
<div class="task-statistics" aria-live="polite">
<span data-task-total>全部任务</span>
<span data-task-finished>已完成</span>
<span data-task-remaining>待处理</span>
</div>
</div>
四、模板直接消费响应式数据
Svelte 模板可以直接读取响应式变量,不需要调用额外的 getter。这里使用 {#each} 渲染带稳定 ID 的任务列表,并通过 bind:checked 同步复选框状态。
<label for="filter">筛选任务</label>
<input id="filter" bind:value={query} placeholder="输入关键词" />
<p>已完成 {finishedCount} 项,剩余 {remainingCount} 项</p>
<ul>
{#each visibleTasks as task (task.id)}
<li>
<label>
<input type="checkbox" bind:checked={task.completed} />
<span class:done={task.completed}>{task.title}</span>
</label>
</li>
{/each}
</ul>
<style>
.done { text-decoration: line-through; opacity: 0.65; }
</style>
列表键使用任务 ID,而不是数组索引,可以减少排序或删除时产生的身份错配。对数据量较大的列表,还应考虑分页或虚拟滚动,不能把所有性能问题归结为框架响应式实现。
<div id="https://github.com/tiktokwuyu-ux/TIKTOK_baike/commit/7e0fb96b3e9b39c5e469149d490d3ea4ecbe9dce" class="task-empty-state">
<h2>当前没有匹配的任务</h2>
<p>可以尝试清除关键词或切换筛选条件。</p>
</div>
五、$effect 应当用于什么
$effect 适合把组件状态同步到非响应式的外部系统,例如第三方图表、浏览器存储或原生媒体 API。它不适合拿来计算完成数,再调用另一个状态的赋值函数;那种数据应该用 $derived 表示。
一个典型场景是把当前筛选词同步到非 Svelte 控件:
<script lang="ts">
import { onMount } from 'svelte';
let filterElement: HTMLInputElement;
let query = $state('');
$effect(() => {
if (filterElement) {
filterElement.setAttribute('aria-label', `任务筛选:${query || '全部'}`);
}
});
</script>
不过,这类简单属性绑定通常可以直接在 Svelte 模板中完成。示例强调的是 effect 与外部 API 的边界:能用模板绑定或派生状态完成的事情,不必额外创建 effect。
<div id="https://github.com/tiktokwuyu-ux/TIKTOK_baike/commit/a724a4a6d324f9de9326e3e35dd6cf38b88078cd">
<section class="filter-notice" aria-label="筛选提示">
<p data-filter-description>筛选条件将即时作用于当前任务列表。</p>
</section>
</div>
六、本地持久化要考虑 SSR 与初始化顺序
在 SvelteKit 等支持服务器渲染的项目中,不能在模块顶层无条件访问 window、localStorage。浏览器存储只能在客户端使用,且必须防止初始空状态在恢复之前覆盖旧数据。
<script lang="ts">
import { onMount } from 'svelte';
let tasks = $state<Task[]>([]);
let hydrated = $state(false);
onMount(() => {
try {
const raw = localStorage.getItem('task-drafts');
if (raw) tasks = JSON.parse(raw);
} catch (error) {
console.warn('读取本地草稿失败', error);
} finally {
hydrated = true;
}
});
$effect(() => {
if (!hydrated) return;
try {
localStorage.setItem('task-drafts', JSON.stringify(tasks));
} catch (error) {
console.warn('保存本地草稿失败', error);
}
});
</script>
上面展示的是持久化控制思路;生产环境要对 JSON.parse 的结构进行校验,并对数据格式演进设置版本。需要跨设备同步时,本地存储应视为缓存而非权威来源。
<div id="https://github.com/tiktokwuyu-ux/TIKTOK_baike/commit/11b621f3053d5586a1c6a1164bfa23986b1269dd">
<div class="draft-status" role="status" aria-live="polite">
<span data-saved-at>本地草稿状态</span>
</div>
</div>
七、如何处理异步请求与过期结果
组件可能需要根据关键词查询远程数据。此时不要仅依赖 $derived 发起请求;它应该保持纯计算。请求副作用需要明确取消机制,保证旧条件的响应不会覆盖新条件。
可以在状态变化时触发请求,并利用 AbortController 在清理函数中取消上一次读取。还应根据实际接口设计版本检查、加载状态和错误类型。对于 SvelteKit 页面级数据,优先评估框架自带的 load 机制,避免同一资源在服务端和客户端重复获取。
<div id="https://github.com/tiktokwuyu-ux/TIKTOK_baike/commit/75fbc987cc7f204c00fe0838efc5c0ad58ddf880">
<section class="remote-search">
<h2>远程任务搜索</h2>
<output data-search-progress aria-live="polite">等待输入</output>
<div data-remote-results></div>
</section>
</div>
如果搜索结果在页面之间需要共享,建议把筛选条件放到 URL,服务端按规范化参数返回数据。把所有条件保存在某个深层子组件内,会让刷新恢复和历史导航变得困难。
八、组件拆分的关键是明确谁能修改状态
当任务项变成单独的 TaskRow.svelte 后,父组件可以向子组件传递记录和回调。对可变数据而言,最重要的是约定“谁拥有修改权”,而不是追求极端的组件数量。一个稳健设计是父组件拥有任务集合,子组件派发操作意图,父组件执行数据变更。
<!-- TaskRow.svelte -->
<script lang="ts">
let { title, completed, onToggle } = $props<{
title: string;
completed: boolean;
onToggle: () => void;
}>();
</script>
<button type="button" onclick={onToggle} aria-pressed={completed}>
{completed ? '撤销完成' : '标记完成'}:{title}
</button>
这样的接口避免子组件直接操作全局数组,更适合测试。如果真实业务需要深层双向编辑,Svelte 也提供绑定相关机制,但应评估状态所有权与调试成本。
<div id="https://github.com/tiktokwuyu-ux/TIKTOK_baike/commit/4a4b32fb5a07e0aeee5d35946b751cd2b0398329" class="component-boundary-example">
<p>任务列表负责数据集合,任务项只负责展示与操作通知。</p>
</div>
九、什么时候应该关注性能
对中小型表单和列表,优先保证状态逻辑正确。性能测试应在真实数据量下进行,检查大型派生计算、频繁外部副作用和 DOM 节点数。把大量独立的中间状态复制到各个组件,通常比单次合理的派生计算更难维护。
另一个误区是“Runes 能自动解决一切异步问题”。响应式系统负责追踪状态变化,却不能自动知道接口响应的业务新旧顺序。请求取消、错误恢复与服务端一致性仍需要单独设计。
十、总结
Svelte 5 的核心不是用新的符号替换旧语法,而是明确区分三类职责:$state 保存可变事实,$derived 根据事实计算视图,$effect 与外部系统同步。围绕这三层组织业务,再加上明确的组件所有权、持久化初始化与异步请求处理,可以让 Svelte 项目在功能增加后保持清晰的数据流,而不是逐步演变成难以追踪的副作用集合。