从 Svelte 4 迁移到 5

Svelte 5 基本上向后兼容。您可以逐个组件进行迁移。

运行迁移脚本即可自动转换旧语法。

代码转换工具会将 export let 重写为 $props()，将 $: 重写为 $derived/$effect，等等。

请始终检查迁移后的代码。有些模式需要手动决定。

新旧语法可以存在于同一个文件中；Svelte 5 会按代码块进行识别。

$state 代理会使 array.push() 具有响应式。您可以删除旧的变通性重新赋值。

createEventDispatcher 被通过 $props() 传递的回调属性取代。

插槽仍然可用；对于新组件，请考虑改写为代码片段。

svelte/store 仍受支持。您可以继续使用存储，也可以将应用状态重构为 $state。

大多数库同时面向两个版本；请一次更新一个组件。

Svelte 5 文档包含迁移指南以及并排对比。

使用 npx sv migrate svelte-5 迁移到 Svelte 5；旧语法仍然有效，便于逐步采用新版本。