解构 props 或 reactive 对象会导致响应性丢失,应使用 toRefs 或 toRef 转为响应式引用;组合式函数中需避免纯函数处理和直接赋值导致的响应中断。

别直接解构 props 或 reactive 对象
在 script setup 中,defineProps 返回的是响应式 Proxy 对象,reactive 创建的也是 Proxy。一旦写 const { title, count } = defineProps(...) 或 const { name } = reactive({...}),得到的就是普通值——不是 ref,也不走 Vue 的依赖追踪链。后续父组件改 title,你解构出的变量不会更新,模板里也收不到变化。
用 toRefs 统一转成响应式引用
这是最常用也最稳妥的方式,尤其适合 props 字段较多、需要解构使用的场景:
- 导入:
import { toRefs } from 'vue' - 对
defineProps结果调用:const { title, count } = toRefs(props) - 暴露给模板时,直接返回这些解构项:
return { title, count } - 在 script 中读写需加
.value(如title.value = 'New'),但模板中可省略,仍写{{ title }}
按需提取用 toRef,更轻量
如果只用到一两个 prop,不想全量转换,toRef 更精准:
import { toRef } from 'vue'-
const title = toRef(props, 'title')→ 得到一个响应式 ref const count = toRef(props, 'count')- 同样支持读写
.value,且不会创建多余引用
组合式函数里也要守边界
在自定义组合式函数(composable)中,响应式丢失常发生在以下环节:
- 把
reactive对象传进纯函数(如lodash.cloneDeep或JSON.parse(JSON.stringify()))→ 返回普通对象,响应性中断 - 异步请求后直接赋值给局部变量:
let data = null; data = await api.get()→ 原 ref 或 reactive 引用被覆盖 - 正确做法是:用
toRefs处理入参;异步结果赋给ref.value或reactive对象的属性;深拷贝后若需响应式,用reactive()重新包装
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










