Vue 3.5 正式发布，代号 “天元突破红莲螺岩”

Vue 官方今天发布 Vue 3.5 正式版，我们一起来看看都有哪些变化？

今天我们很兴奋地宣布 Vue 3.5 “天元突破红莲螺岩”(Tengen Toppa Gurren Lagann) 版本发布！这个小版本不包含任何破坏性变更，同时包括了内部改进和实用的新功能。

我们将在这篇博文中介绍一些亮点 - 如需完整的变更和新功能列表，请参阅 GitHub 上的完整更新日志。

https://github.com/vuejs/core/blob/main/CHANGELOG.md

响应式系统优化

在 3.5 中，Vue 的响应式系统经历了又一次重大重构，实现了更好的性能和显著减少了内存占用 (-56%)，且没有行为变化。这次重构还解决了 SSR 过程中由于悬挂的计算属性导致的过时计算值和内存问题。

此外，3.5 还优化了对大型、深度响应式数组的响应式追踪，在某些情况下使此类操作的速度提高了多达 10 倍。

响应式 Props 解构

响应式 Props 解构在 3.5 中已经稳定。该功能现在默认启用，在 <script setup> 中从 defineProps 调用解构的变量现在是响应式的。值得注意的是，这个功能通过利用 JavaScript 的原生默认值语法，大大简化了声明带有默认值的 props：

Before

const props = withDefaults(

After

const { count = 0, msg = 'hello' } = defineProps<{

访问解构变量 (例如 count) 时，编译器会自动将其编译为 props.count，因此它们在访问时会被追踪。与 props.count 类似，如果要观察解构的 prop 变量或将其传递给组合式函数并保持响应性，需要将其包装在一个 getter 中：

watch(count /* ... */)

对于那些更喜欢将解构的 props 与普通变量区分开来的人，@vue/language-tools2.1 版本已经发布了一个可选设置，可以为它们启用内联提示：

详情：

• 使用方法和注意事项请参阅文档。
• 有关此功能的历史和设计理念，请参阅 RFC#502。

https://vuejs.org/guide/components/props.html#reactive-props-destructure
https://github.com/vuejs/rfcs/discussions/502

SSR 改进

3.5 为服务器端渲染 (SSR) 带来了一些期待已久的改进。

Lazy Hydration  懒加载水合

异步组件现在可以通过 defineAsyncComponent()API 的 hydrate 选项来控制何时进行水合。例如，只在组件变为可见时才进行水合：

import { defineAsyncComponent, hydrateOnVisible } from 'vue'

核心 API 故意设计得比较底层，Nuxt 团队已经在这个功能之上构建了更高级的语法糖。

useId()

useId() 是一个可以用来生成应用内唯一 ID 的 API，这些 ID 保证在服务器和客户端渲染之间保持稳定。它们可以用于生成表单元素和无障碍属性的 ID，并且可以在 SSR 应用中使用而不会导致水合不匹配：

<script setup>

data-allow-mismatch

在客户端值不可避免地与其服务器端对应值不同的情况下 (例如日期)，我们现在可以使用 data-allow-mismatch 属性来抑制由此产生的水合不匹配警告：

<span data-allow-mismatch>{{ data.toLocaleString() }}</span>

您还可以通过为该属性提供一个值来限制允许哪些类型的不匹配，可能的值包括 text、children、class、style 和 attribute。

自定义元素改进

3.5 修复了许多与 defineCustomElement()API 相关的长期存在的问题，并为使用 Vue 创建自定义元素添加了一些新功能：

• 通过 configureApp 选项支持自定义元素的应用配置。
• 添加 useHost()、useShadowRoot() 和 this.$hostAPI，用于访问自定义元素的宿主元素和影子根。
• 通过传递 shadowRoot: false 支持挂载不带影子 DOM 的自定义元素。
• 支持提供 nonce 选项，该选项将附加到自定义元素注入的 <style> 标签上。

这些新的仅用于自定义元素的选项可以通过第二个参数传递给 defineCustomElement：

import MyElement from './MyElement.ce.vue'

其他值得关注的特性

useTemplateRef()

3.5 引入了一种通过 useTemplateRef()API 获取模板引用的新方法：

<script setup>

在 3.5 之前，我们建议使用普通的 ref，其变量名与静态 ref 属性匹配。旧方法要求 ref 属性可以被编译器分析，因此仅限于静态 ref 属性。相比之下，useTemplateRef() 通过运行时字符串 ID 匹配 ref，因此支持动态 ref 绑定到变化的 ID。

@vue/language-tools2.1 也为新语法实现了特殊支持，因此在使用 useTemplateRef() 时，根据 ref 属性存在与否会有自动完成和警告出现：

Deferred Teleport  延迟传送门

内置 <Teleport> 组件的一个已知限制是，其目标元素必须在传送门组件挂载时存在。这阻止了用户将内容传送到 Vue 在传送门之后渲染的其他元素。

在 3.5 中，我们为 <Teleport> 引入了一个 defer 属性，它会在当前渲染周期之后挂载传送门，所以现在这样做是可行的：

<Teleport defer to="#container">...</Teleport>

这种行为需要 defer 属性，因为默认行为需要向后兼容。

有关 3.5 中变更和功能的完整列表，请查看 GitHub 上的完整更新日志。
https://github.com/vuejs/core/blob/main/CHANGELOG.md