Vue 3 Watch 监听 Props 的踩坑记录

问题描述

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

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

问题分析

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

解决方案

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

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

原理解析

不使用箭头函数时：

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

使用箭头函数时：

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

 响应式追踪示例

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

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

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

总结

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