Vue3子组件watch无法监听父组件传递的属性值

1 问题描述

假设子组件 ChildComponent 中有个属性a，默认值为 0，并且通过侦听器 watch 监听其数值变化。在父组件 ParentComponent 中调用子组件并将属性a的值赋为1传递给子组件，发现子组件模板中a的值是1，但是 watch 并未监听到属性a的值发生了变化。

子组件示例代码：

<template>
  <!-- a的值显示为1 -->
  <div>{{ a }}</div>
</template>

<script setup>
import { watch } from 'vue'

const props = defineProps({
  a: {
    type: Number,
    default: 0
  }    
})

watch(
  () => props.a,
  (newValue, oldValue) => {
    // 下方信息不会打印在控制台中
    console.log('a has changed', newValue, oldVlue)
  }
)
</script>

父组件示例代码：

<template>
  <ChildComponent :a="1" />
</template>

2 引发原因

Vue官网：watch 默认是懒执行的：仅当数据源变化时，才会执行回调。

Vue 在渲染模板时，先渲染子组件，然后渲染父组件。子组件在初始化时，属性a的值被赋为默认值0，然后父组件进行初始化，将 a=1 传递给子组件，子组件接收后将新值覆盖掉原来的旧值，完成初始化。由于子组件属性是响应式的，所以从0变化为1后，会更新模板视图。该过程发生在组件初始化阶段，watch 函数首次进行绑定，不认为数据源发生了变化，所以不会执行回调。

3 解决方法

Vue 提供了 immediate 属性，设置该属性后可以让 watch 函数首次绑定后立即执行一次回调，获取最新的属性值。

watch(
  () => props.a,
  (newValue, oldValue) => {
    // 打印结果为 a has changed, 1, 0
    console.log('a has changed', newValue, oldVlue)
  },
  { immediate: true } // 添加此行
)