ref、reactive、toRefs、shallowRef——API 都会背,真正翻车的是这几种情况。

整理笔记

一、ref 在模板里不用 .value,在 script 里必须写

1
2
3
4
5
6
7
8
9
10
<script setup>
const count = ref(0)
function add() {
count.value++ // script 里要 .value
}
</script>

<template>
<span>{{ count }}</span> <!-- 模板里自动解包 -->
</template>

坑在「传出去」的时候:someFn(count) 传的是 ref 对象,不是数字。想传值就写 count.value。

二、reactive 解构会丢响应,这是最常见的 bug

1
2
3
4
const state = reactive({ a: 1, b: 2 })
const { a } = state // a 只是个普通数字,改它不会更新视图

const { a: ra } = toRefs(state) // 正确:ra 是 ref,读写都连着源对象

想让解构保持响应,一律 toRefs。或者干脆全程 ref,团队里统一一种写法比什么都对更重要。

三、整体替换对象会让 reactive 断链

1
2
let state = reactive({ list: [] })
state = { list: [1, 2, 3] } // 变量指向新对象,原来的响应式代理被扔掉

要么用 ref:

1
2
const state = ref({ list: [] })
state.value = { list: [1, 2, 3] } // 正常

要么逐字段赋值。判断口诀:这个对象会被整体替换吗?会就用 ref。

四、大对象别用 ref 全程深度监听

一个上万条数据的表格,每次改一个字段都深度遍历,卡得莫名其妙。

1
2
3
4
const rows = shallowRef([])          // 只有整体替换才触发
async function reload() {
rows.value = await fetchRows() // 整体换,视图更新
}

shallowRef 的语义是「我只关心引用变没变」。配合 triggerRef(rows) 手动触发也行。

五、watch 和 watchEffect 分工

用途 注意
watch 明确知道要监听谁 默认浅比较,对象内部变化要 deep: true
watchEffect 依赖自动收集 会跑两次(初始化 + 依赖变化),慎用于请求
1
2
3
4
5
6
7
8
// 需要在组件卸载时取消的请求,交给 watchEffect 的 cleanup
watchEffect((onCleanup) => {
const controller = new AbortController()
fetch(`/api/user/${id.value}`, { signal: controller.signal })
.then(r => r.json())
.then(d => (user.value = d))
onCleanup(() => controller.abort())
})

多个请求同时飞回来写同一个变量,是「数据乱跳」的头号原因,AbortController 是最省事的解法。

六、computed 别写副作用

1
2
3
4
5
6
7
8
// 错:在 computed 里改别的状态
const full = computed(() => {
total.value = price.value * qty.value // 副作用,会警告甚至死循环
return total.value
})

// 对:computed 只算,赋值放到 watch 或事件里
const full = computed(() => price.value * qty.value)

七、props 改不了,别想着「先改再同步」

1
2
3
props.value = 1        // 报错
const local = ref(props.value) // 想编辑:本地拷贝
watch(() => props.value, v => (local.value = v))

父组件是数据的唯一来源,子组件存草稿。

小结清单

  • script 里 ref 记得 .value,模板里不用
  • reactive 解构必 toRefs
  • 对象会被整体替换 → 用 ref
  • 大数据列表 → shallowRef
  • 请求类副作用配 AbortController 清场
  • computed 只算不写
  • props 只读,编辑用本地草稿

下次写 Spring Boot 接 Meilisearch,把 Windows 和 Linux 两套环境都过一遍。