解构 reactive 对象会丢失响应式,因为解构得到的是值的副本而非 proxy 代理;torefs 将每个属性转为 ref,保持与源对象的响应式连接。

直接解构 reactive 对象会丢失响应式,因为 JavaScript 解构拿到的是值的副本,脱离了 Proxy 的拦截范围;toRefs 的作用就是把每个属性转成独立的 ref,让解构后的变量仍能双向同步源对象。
为什么解构 reactive 就不响应了?
Vue 3 的响应式靠 Proxy 实现,它只代理整个对象,不代理“从中取出来的某个属性”。比如:
const state = reactive({ count: 0 });
const { count } = state; // ❌ 这里 count 是数字 0,普通值
count++; // 页面完全没反应
这行解构相当于做了 const count = state.count——一次快照拷贝,后续修改与 state 再无关系。
使用 `@ainative/vue-sdk` 为 Vue 3 应用添加 AI 聊天功能。适用于以下场景:(1) 安装 `@ainative/vue-sdk`,(2) 在 Vue 组件中使用 `useChat` 组合式函数,(3) 提供……
toRefs 怎么用才有效?
必须严格按顺序:先 reactive 创建对象 → 再用 toRefs 包裹 → 最后解构。例如:
- 导入并创建:
import { reactive, toRefs } from 'vue' - 统一管理状态:
const state = reactive({ count: 0, name: 'Alice' }) - 包裹后解构:
const { count, name } = toRefs(state) - 在
setup中返回:return { count, name }
此时 count 和 name 都是 ref,模板中可直接写 {{ count }},脚本中需通过 count.value++ 修改。
常见搭配场景和注意点
toRefs 不是万能胶,用错地方反而埋坑:
- 对
ref({})类型不能直接toRefs(refObj),要先取.value:toRefs(user.value) - 多个
reactive对象建议分别处理:{ ...toRefs(user), ...toRefs(config) } - 新增属性(如
state.newField = 'x')会被 Proxy 拦截,但若该字段在toRefs执行前不存在,解构结果里就没有对应 ref,也就无法响应 - 不需要给函数或计算属性套
toRefs,它们本身不依赖响应式代理
toRef 和 toRefs 该怎么选?
两者都维持与源对象的链接,但适用粒度不同:
-
toRef(state, 'count'):适合只暴露单个字段,比如从 props 或 store 中“拎出”一个属性做局部监听 -
toRefs(state):适合整组状态批量解构,组合式函数对外暴露时的标准做法 - 不推荐混用:
const { a } = toRefs(s1); const b = toRef(s2, 'b')——逻辑松散,维护成本高
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!









