Vue 3 Watch 监听 Props 的踩坑记录

weixin_516875652025-04-24 13:51

问题描述

最近在写一个基础下拉组件时，遇到了一个关于 watch 监听 props 值变化的问题。起初的代码是这样的：

javascript 复制代码

// ❌ 错误示例
watch([options, props.modelValue], ([newOptions, newModelValue]) => {
  // 发现无法正确获取到 props.modelValue 的最新值
})

问题分析

在排查过程中发现，直接使用 props.modelValue 作为监听源时，只能获取到 props 的初始值，而无法检测到后续的变化。

解决方案

经过查阅 Vue 3 文档和社区讨论，发现需要使用箭头函数来包装 props 值：

javascript 复制代码

// ✅ 正确示例
watch([options, () => props.modelValue], ([newOptions, newModelValue]) => {
 // 现在可以正确获取到 props.modelValue 的最新值了
})

原理解析

不使用箭头函数时：

javascript 复制代码

const value = props.modelValue;  // 直接访问，只获取一次值
watch(value, () => {})  // 监听的是一个静态值

使用箭头函数时：

javascript 复制代码

const getter = () => props.modelValue;  // 创建 getter 函数
watch(getter, () => {})  // 每次都会重新执行 getter 获取最新值

响应式追踪示例

javascript 复制代码

// 在组件中的实际应用
watch(
  [
    options,  // ref 对象可以直接监听
    () => props.modelValue  // props 需要通过 getter 函数监听
 ],
  ([newOptions, newValue]) => {
    // 能够正确响应两个值的变化
  }
)

总之，使用箭头函数可以确保：

正确追踪响应式依赖
每次都能获取到最新的 prop 值
保持响应式系统的完整性

总结

监听 ref/reactive 对象：可以直接使用
监听 props：使用箭头函数包装
需要深度监听时：添加 { deep: true } 配置