Svelte 5 响应式实战:Runes、派生状态与组件设计

简介: Svelte 5 Runes 以 `$state`、`$derived`、`$effect` 显式划分状态、计算与副作用,让复杂依赖关系清晰可溯;支持跨组件复用,告别隐式响应式陷阱,提升可维护性与性能。(239字)

很多前端项目的复杂性不是来自页面数量,而是来自状态之间的关系:搜索框改变了列表,列表又影响统计数字,用户勾选一条记录后,多个组件必须同步更新。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 项目在功能增加后保持清晰的数据流,而不是逐步演变成难以追踪的副作用集合。

相关文章
|
6天前
|
Linux Go 开发工具
手机上跑 DeepSeek 智能体:开源安卓客户端 DSH Go 安装与使用指南
DSH Go 是一款开源安卓客户端,将 DeepSeek Harness 智能体引擎装进手机:免 Root、免 Termux,一键安装即用;支持本机运行(内置 Ubuntu+Node.js)或远程接管电脑会话;具备插话打断、过程折叠、屏幕操控、端到端加密分享等特色功能,真正实现智能体“口袋化”。
7824 19
|
6天前
|
弹性计算 人工智能 API
Codex超详细入门指南(下载·安装·登录·上手,全版本覆盖,2026最新版)
建议收藏本教程,2026 全年各版本更新随时回来查阅。如果你在搭建过程中遇到任何问题,欢迎结合 阿里云工单系统 提交技术支持请求,或在 阿里云开发者社区 搜索 Codex 相关话题交流。 祝你编码愉快,效率翻倍!
2510 12
|
1天前
|
人工智能 安全 应用服务中间件
NGINX 爆出两处高危漏洞 可导致未经身份验证的远程代码执行
NGINX曝出两个高危漏洞(CVE-2026-123633和CVE-2026-123007),CVSS 9.2分,均属HTTP/2内存安全缺陷,无需认证即可远程执行代码。影响自2015年起的多个版本,静态站点亦受威胁。修复版本为开源版1.30.7/1.31.9。(239字)
1228 0
NGINX 爆出两处高危漏洞 可导致未经身份验证的远程代码执行
|
4天前
|
传感器 安全 区块链
Windows 电脑运行安卓应用教程:开源工具 ApkStart 双击 APK 即装、独立窗口运行
ApkStart 是一款开源Windows工具,让安卓APP像原生软件一样运行:双击APK即安装、生成真实图标、独立窗口启动、开始菜单可搜索。无需传统模拟器,内置QEMU运行时,支持数据互通、ARM兼容与命令行操作。(239字)
|
9天前
|
人工智能 前端开发 API
阿里云Qwen4-Max 大模型详解:定位、特征、能力、适用场景与相对Qwen3-Max差异解析
2026年11月11日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问AI平台Token Plan并接入千问办公、Qoder等入口。该版本聚焦知识理解、世界感知、编程与Agentic四项升级,主打复杂编程、专业办公、前端设计与专业软件操作等真实任务。预览期为11月11日10:00至11月25日24:00,仅支持Token Plan调用,到期后模型标识下线;限时2折、新用户再享5折,最低1折可体验。
|
9天前
|
JSON 前端开发 API
阿里云最新Qwen4-Max大模型介绍:模型定位、特征、能力、适用场景解析
2026 年 11 月 11 日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问 AI 平台 Token Plan,并同步接入千问办公、Qoder 等入口。该版本聚焦知识理解、世界感知、编程与 Agentic 四项升级,主打复杂编程、专业办公、前端设计与专业软件操作。预览期至 11 月 25 日 24:00,到期后模型标识下线;限时 2 折、新用户再享 5 折,最低 1 折可体验。
|
21天前
|
Linux 开发工具 iOS开发
Codex保姆级教程(下载+安装+登录+使用,含所有版本,2026最新)
Codex是OpenAI推出的开源AI编程智能体,本地运行,可理解整个代码库,支持自然语言指令改代码、执行命令、跑测试、修Bug,兼容Win/macOS/Linux。(239字)
10602 59
|
5天前
|
人工智能 弹性计算 开发工具
零成本玩各大模型!DeepSeek Harness dsh-our-free-model 插件,13 个厂商模型直接用
总结一下:装这个插件,你不用注册、不用绑卡、不用填一个 Key,就能在 DeepSeek Harness 里用上 DeepSeek V4.1 Flash、Kimi K3 这一批前沿模型,而且是白嫖的、还不限量。三步搞定:下载插件,复制包含 `package.json` 的插件目录路径,在「添加插件」里粘贴路径安装并重启。无论是在阿里云 ECS 上通过命令行部署的 Web 版,还是本地的 Electron 桌面端,都能顺利跑通,快速搭建一套零成本的免费模型使用环境。
1146 1
|
7天前
|
Linux API iOS开发
【DSH】DeepSeek Harness新手保姆教程(下载+安装+配置+使用,2026最新实测)
DeepSeek Harness(dsh)是DeepSeek AI开源的智能体框架,秉持“一切皆插件”理念,支持读文件、改代码、跑命令、处理表格、联网搜索等操作。免费开源,兼容Windows/macOS/Linux,提供桌面端与网页端,可灵活安装插件扩展能力。

热门文章

最新文章