Vue / 知识点

Vue 3 开发速查手册

手册条目

定位监听回调修改自身依赖导致的重复执行和页面卡顿。

排查监听无限循环

当 watch 回调或多个响应式副作用间接写回自己的依赖时,组件可能反复更新,表现为 CPU 占用升高、页面卡死,或控制台出现递归更新警告。watchEffect 能抑制部分同步自触发,但异步写回和跨监听闭环仍需排查。重点不是调整执行时机,而是找出“读取依赖 → 回调写回同一依赖”的闭环。

快速定位

先确认是否存在以下特征:删除某个监听后页面恢复;回调内直接修改监听源,或调用的方法间接修改监听源;监听对象使用了 deep: true,回调又改动其任意子属性;多个监听互相写入,形成 A 更新 B、B 再更新 A 的环。

下面是片段示例,可在开发环境为可疑监听加入触发日志。onTrack 显示依赖何时被收集,onTrigger 显示哪个响应式操作再次触发监听;这两个调试钩子只应临时使用,不要把高频日志带入生产环境。

ts
watch(
  () => form.value,
  () => validateAndNormalize(),
  {
    deep: true,
    onTrigger(event) {
      console.log('[watch trigger]', event.type, event.key)
    }
  }
)

预期结果

text
[watch trigger] set quantity
[watch trigger] set total
[watch trigger] set quantity

同一组字段持续交替出现,通常说明回调或其调用链正在写回监听依赖。实际字段名取决于业务对象。

监听依赖自写导致循环及安全替代路径

典型错误与修复

下面的组件中,监听回调每次都递增 count。用户点击一次后,回调修改了自己的监听源,因此会持续调度更新。

vue
<script setup lang="ts">
import { ref, watch } from 'vue'

const count = ref(0)

watch(count, () => {
  count.value++
})
</script>

<template>
  <button @click="count++">count: {{ count }}</button>
</template>

预期结果(错误现象)

text
[Vue warn]: Maximum recursive updates exceeded in component <COMPONENT>

组件名和完整警告文字可能随 Vue 版本及构建模式不同,但页面卡顿和数值持续增长是关键现象。

优先把“根据状态计算另一个值”改成 computed,避免用监听器同步派生状态。以下片段替换同一组件的脚本和模板后,点击只更新源值,派生值由 Vue 缓存计算,不会写回依赖。

vue
<script setup lang="ts">
import { computed, ref } from 'vue'

const count = ref(0)
const doubled = computed(() => count.value * 2)
</script>

<template>
  <button @click="count++">
    count: {{ count }}, doubled: {{ doubled }}
  </button>
</template>

预期结果

text
首次点击:count: 1, doubled: 2
再次点击:count: 2, doubled: 4
控制台无递归更新警告

确实需要在监听中规范化源值时,必须保证写入可以收敛,并在写入前比较新旧值。下面是沿用上方 count 的片段示例,最多额外触发一次:只有输入超出范围时才回写规范化结果。

ts
watch(count, (value) => {
  const normalized = Math.max(0, Math.min(value, 10))

  // 相同值不回写,避免无意义触发;规范化后必须能稳定在固定值
  if (normalized !== value) {
    count.value = normalized
  }
})

预期结果

text
输入 12:count 先变为 12,随后稳定为 10
输入 8:count 保持 8,不发生额外写入

高频排查顺序

  1. 临时注释可疑监听,确认卡顿是否消失。
  2. 搜索回调内对监听源的直接赋值,以及调用链中的 store action、表单格式化和路由同步写入。
  3. 将 deep: true 暂时移除或缩小监听源,判断是否由无关子属性触发。
  4. 检查多个监听、computed setter、Pinia 订阅和父子组件 v-model 是否互相回写。
  5. 用新旧值比较、单向数据流或显式事件入口替换双向同步,再恢复监听验证。

风险与边界

把 flush 改成 post 或 sync 只会改变回调执行时机,不能解除依赖闭环;sync 还可能让递归更快暴露。盲目加防抖只能降低触发频率,无法保证状态最终一致。安全替代方案是让派生值使用 computed,副作用监听不修改源值;必须回写时,加入相等判断、明确收敛条件,并限制 deep 监听范围。

速查结论:先画出每个监听“读哪些值、写哪些值”,只要依赖图中出现回到起点的写入路径,就应拆成单向更新或增加可证明收敛的保护条件。

目录与阅读设置

记录一个想法

Vue 3 开发速查手册

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通