Vue侦听器:watch与watchEffect的区别与使用

 更新时间:2026年02月13日 10:21:31   作者:半花  
watch 和 watchEffect 都是 Vue 中用于侦听响应式数据变化的工具,但它们的依赖追踪方式、执行时机和使用场景有显著区别, 下面就来详细的介绍一下,感兴趣的可以了解一下

watch与watchEffect的核心区别

watch 和 watchEffect 都是 Vue 中用于侦听响应式数据变化的工具,但它们的依赖追踪方式、执行时机和使用场景有显著区别。

特性watchwatchEffect
依赖追踪方式显式指定侦听的数据源(如 ref、reactive 属性)隐式追踪回调函数内部的响应式依赖
执行时机默认懒执行(首次不执行,仅在数据源变化时执行)立即执行(组件挂载时立即执行一次)
回调参数提供新值和旧值(如 (newVal, oldVal) => {})无参数(通过函数内部的依赖自动触发)
适用场景需要知道数据变化前后的值,或侦听特定数据源需要根据多个依赖执行副作用(如数据请求)
停止侦听返回一个停止函数(如 const stop = watch(...))返回一个停止函数(如 const stop = watchEffect(...))

使用

watch使用

watch 用于显式侦听一个或多个响应式数据源,当数据源变化时执行回调函数。

  1. 侦听单个 ref
import { ref, watch } from 'vue'; 

const count = ref(0); 

// 侦听 count 的变化 
watch(count, (newVal, oldVal) => { 
    console.log(`count 从 ${oldVal} 变为 ${newVal}`);
});
// 修改 count,触发 watch 回调 
count.value = 1; // 输出:count 从 0 变为 1
  1. 侦听多个 ref
import { ref, watch } from 'vue'; 

const a = ref(0); 
const b = ref(0); 
// 侦听多个数据源 
watch([a, b], ([newA, newB], [oldA, oldB]) => { 
  console.log(`a 从 ${oldA} 变为 ${newA}`); 
  console.log(`b 从 ${oldB} 变为 ${newB}`); 
});

// 修改 a 或 b,触发 watch 回调 
a.value = 1; // 输出:a 从 0 变为 1,b 从 0 变为 0 
b.value = 2; // 输出:a 从 1 变为 1,b 从 0 变为 2
  1. 侦听 reactive 对象的属性
import { reactive, watch } from 'vue'; 

const state = reactive({ count: 0, name: 'Vue' }); 
// 侦听 state.count 的变化 
watch( 
  () => state.count, 
  (newVal, oldVal) => { 
    console.log(`count 从 ${oldVal} 变为 ${newVal}`); 
  } 
);

// 修改 state.count,触发 watch 回调 
state.count = 1; // 输出:count 从 0 变为 1
  1. 深度侦听 reactive 对象
import { reactive, watch } from 'vue';

const state = reactive({ 
  user: { name: 'Vue', age: 3 } 
}); 

// 深度侦听 state.user 的变化 
watch(
  () => state.user, 
  (newVal, oldVal) => {
    console.log('user 对象发生变化', newVal); 
  }, 
  { deep: true } // 开启深度侦听 
); 
// 修改 state.user.age,触发 watch 回调 
state.user.age = 4; // 输出:user 对象发生变化 { name: 'Vue', age: 4 }
  1. 立即执行 watch
import { ref, watch } from 'vue'; 

const count = ref(0); 、

// 立即执行 watch(组件挂载时执行一次) 
watch( 
  count, 
  (newVal, oldVal) => { 
    console.log(`count 当前值为 ${newVal}`);
  }, 
  { immediate: true } // 开启立即执行 
); 
// 输出:count 当前值为 0

watchEffect使用

watchEffect 用于隐式侦听回调函数内部的响应式依赖,当任何依赖变化时执行回调函数。

  1. 基本使用
import { ref, watchEffect } from 'vue'; 

const count = ref(0); 
const name = ref('Vue'); 

// 隐式侦听 count 和 name 的变化 
watchEffect(() => { 
  console.log(`count: ${count.value}, name: ${name.value}`);
}); 
// 输出:count: 0, name: Vue 

// 修改 count,触发 watchEffect 回调 
count.value = 1; // 输出:count: 1, name: Vue 

// 修改 name,触发 watchEffect 回调 
name.value = 'React'; // 输出:count: 1, name: React
  1. 停止侦听
import { ref, watchEffect } from 'vue'; 

const count = ref(0); 

// 停止侦听 
const stop = watchEffect(() => {
  console.log(`count: ${count.value}`); 
}); 

// 修改 count,触发 watchEffect 回调 
count.value = 1; // 输出:count: 1 

// 停止侦听 
stop(); 

// 修改 count,不再触发 watchEffect 回调 
count.value = 2; // 无输出
  1. 清除副作用

watchEffect 支持清除副作用(如取消数据请求、清除定时器等)。

import { ref, watchEffect } from 'vue'; 

const id = ref(0); 

watchEffect((onInvalidate) => { 
  // 模拟数据请求 
  const timer = setTimeout(() => { 
    console.log(`请求数据,id: ${id.value}`);
  }, 1000); 
  
  // 清除副作用(组件卸载或依赖变化时执行) 
  onInvalidate(() => { 
    clearTimeout(timer); 
    console.log('清除定时器');
  });
}); 

// 修改 id,触发 watchEffect 回调 
id.value = 1; 
// 输出:清除定时器,然后 1 秒后输出:请求数据,id: 1

总结

  • watch:适用于需要显式侦听特定数据源,并需要知道数据变化前后值的场景。
  • watchEffect:适用于需要根据多个依赖执行副作用,且不需要关心数据变化前后值的场景。

在实际开发中,应根据具体需求选择合适的侦听器:

  • 如果需要侦听特定数据的变化并获取新旧值,使用 watch
  • 如果需要根据多个依赖执行副作用(如数据请求),使用 watchEffect

到此这篇关于Vue侦听器:watch与watchEffect的区别与使用的文章就介绍到这了,更多相关Vue :watch与watchEffect内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • vue实现登录注册模板的示例代码

    vue实现登录注册模板的示例代码

    这篇文章主要介绍了vue实现登录注册模板的示例代码,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2021-04-04
  • vuex mutations的两种调用方法小结

    vuex mutations的两种调用方法小结

    这篇文章主要介绍了vuex mutations的两种调用方法小结,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-03-03
  • Vue Router4 嵌套路由的示例代码

    Vue Router4 嵌套路由的示例代码

    在 Vue Router 4 中,嵌套路由是一种非常重要的功能,它允许我们创建更复杂的 UI 结构,同时保持路由的清晰和易于管理,这篇文章主要介绍了Vue Router4 嵌套路由,需要的朋友可以参考下
    2024-04-04
  • 解决vue的变量在settimeout内部效果失效的问题

    解决vue的变量在settimeout内部效果失效的问题

    今天小编就为大家分享一篇解决vue的变量在settimeout内部效果失效的问题,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2018-08-08
  • vue实现websocket客服聊天功能

    vue实现websocket客服聊天功能

    这篇文章主要为大家详细介绍了vue实现websocket客服聊天功能,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2021-10-10
  • Vuex 进阶之模块化组织详解

    Vuex 进阶之模块化组织详解

    这篇文章主要介绍了Vuex 进阶之模块化组织详解,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-01-01
  • vue实现导航栏效果(选中状态刷新不消失)

    vue实现导航栏效果(选中状态刷新不消失)

    这篇文章主要为大家详细介绍了vue实现导航栏效果,选中状态刷新不消失,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2017-12-12
  • Vue项目中env文件的作用和配置详解

    Vue项目中env文件的作用和配置详解

    Vue项目中,.env文件是运行项目时的环境配置文件,但是在实际开发过程中,有本地开发环境、测试环境、生产环境等,不同环境对应的配置会不一样,本文给大家介绍了Vue项目中env文件的作用和配置,需要的朋友可以参考下
    2024-12-12
  • Vant Weapp组件踩坑:picker的初始赋值解决

    Vant Weapp组件踩坑:picker的初始赋值解决

    这篇文章主要介绍了Vant Weapp组件踩坑:picker的初始赋值解决,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-11-11
  • vue的过滤器filter实例详解

    vue的过滤器filter实例详解

    本文通过实例代码给大家介绍了vue的过滤器filter的相关知识,非常不错,具有一定的参考借鉴价值,需要的朋友可以参考下
    2018-09-09

最新评论