toRefs 是解决 Vue 3 对象解构后响应式丢失的标准方案,它将 reactive 对象的每个属性转为 ref,保持双向同步;因 Proxy 只代理整个对象,解构会脱离追踪,故需 toRefs 包裹后再解构。

使用 toRefs 是解决 Vue 3 中对象解构后响应式丢失问题的标准做法。它把响应式对象的每个属性都转成独立的 ref,确保解构后的变量依然能触发视图更新。
为什么解构会丢失响应式?
Vue 的响应式是基于 Proxy 实现的,只对整个响应式对象生效。一旦你用解构从 reactive 或 ref 对象中取出某个属性,得到的就是一个普通值(或普通引用),脱离了 Proxy 的追踪范围。
例如:
❌ 错误写法(响应式丢失):const state = reactive({ count: 0 });<br>const { count } = state; // count 是普通数字,修改它不会更新视图
toRefs 怎么用?
toRefs 接收一个响应式对象,返回一个由 ref 组成的新对象,每个 ref 都与原对象的对应属性保持双向同步。
✅ 正确写法:
- 先用
reactive创建响应式对象 - 再用
toRefs包裹它 - 最后安全解构
import { reactive, toRefs } from 'vue';<br>const state = reactive({ count: 0, name: 'Alice' });<br>const { count, name } = toRefs(state); // ✅ 全是 ref,可响应
注意:使用时需通过 .value 读写(在模板中可省略)。
配合 setup 和解构的常见模式
在 setup() 中,推荐将逻辑分组并统一用 toRefs 暴露:
- 把多个
reactive对象分别处理,避免混在一起 - 如果需要合并多个响应式对象,先
toRefs再用...spread解构 - 对计算属性或函数,直接返回即可,无需
toRefs
示例:
const user = reactive({ id: 1, nickname: 'Bob' });<br>const config = reactive({ theme: 'dark', lang: 'zh' });<br>return { ...toRefs(user), ...toRefs(config), reset() { /* ... */ } };
替代方案对比:toRef vs toRefs
toRef 适用于只提取单个属性(比如想给某个字段单独加 watch),而 toRefs 更适合批量解构整个对象。
-
toRef(obj, 'count')→ 返回单个 ref,不依赖 obj 是否响应式 -
toRefs(obj)→ 要求 obj 必须是响应式对象,返回所有属性的 ref 映射 - 对非响应式对象调用
toRefs不会报错,但返回的是空对象

















