Vue 3 响应式系统:ref 与 reactive 的边界

Vue 3 用 Proxy 追踪依赖,数据变化后精确通知相关视图更新。理解这一点,能避开大部分「改了但没更新」的问题。

响应式的本质

组件的渲染过程会收集依赖;当依赖变化时,重新执行相关的副作用。关键在于:只有被 Proxy 包裹的对象才能被追踪。

ref 与 reactive

  • ref:包裹任意值,通过 .value 访问,模板中自动解包
  • reactive:只能包裹对象,直接访问属性
const count = ref(0)
const state = reactive({ page: 1, size: 10 })

count.value++
state.page++

实践建议:优先使用 ref。它类型更稳定,也能安全地整体替换。

解构会丢失响应式

const state = reactive({ count: 0 })
const { count } = state // count 只是一个普通数字

需要解构时,用 toRefs 保留引用:

const { count } = toRefs(state)

computed 与 watch

const keyword = ref('')
const filtered = computed(() => posts.value.filter((post) => post.title.includes(keyword.value)))

watch(keyword, (value) => {
  console.log('搜索词变化:', value)
})
  • computed 有缓存,依赖不变不会重复计算
  • watch 默认懒执行,immediate: true 可立即触发
  • 需要监听对象深层变化时,使用 deep: true,但要评估性能成本

shallowRef 与性能

对于大型只读数据(如接口返回的长列表),shallowRef 只追踪引用变化,不做深层代理。

const posts = shallowRef<Post[]>([])

async function refresh() {
  posts.value = await fetchPosts()
}

只要整体替换引用,视图就会更新,同时避免深层响应式带来的开销。

常见陷阱

  1. 把响应式对象直接解构后再传给模板
  2. 用 reactive 包裹基本类型
  3. 在 watch 中修改被监听的值,造成循环触发
  4. 组件卸载后仍持有响应式引用,导致内存无法释放
  5. 误以为 ref 数组的索引变化一定能被追踪

排查思路

  • 确认数据是否被 Proxy 包裹
  • 确认修改的是同一个引用链路
  • 用 Vue DevTools 查看组件依赖与更新来源
  • 需要强制刷新时,优先查找响应式丢失,而不是加 key