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如何实现点击文字添加颜色(动态修改class)

    VUE如何实现点击文字添加颜色(动态修改class)

    这篇文章主要介绍了VUE如何实现点击文字添加颜色(动态修改class),具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2023-11-11
  • 如何让别人访问本地运行的vue项目

    如何让别人访问本地运行的vue项目

    这篇文章主要介绍了如何让别人访问本地运行的vue项目,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-10-10
  • Vue实现Excel预览功能使用场景示例详解

    Vue实现Excel预览功能使用场景示例详解

    这篇文章主要为大家介绍了Vue实现Excel预览功能使用场景示例详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-09-09
  • Vue.js实战之组件的进阶

    Vue.js实战之组件的进阶

    组件(Component)是 Vue.js 最强大的功能之一,之前的文章都只是用到了基本的封装功能,这次将介绍一些更强大的扩展。这篇文章主要介绍了Vue.js实战之组件进阶的相关资料,需要的朋友们可以参考借鉴,下面来一起看看吧。
    2017-04-04
  • Vue2中使用axios的3种方法实例总结

    Vue2中使用axios的3种方法实例总结

    axios从功能上来说就是主要用于我们前端向后端发送请求,是基于http客户端的promise,面向浏览器和nodejs,下面这篇文章主要给大家介绍了关于Vue2中使用axios的3种方法,需要的朋友可以参考下
    2022-09-09
  • vue实现移动端input上传视频、音频

    vue实现移动端input上传视频、音频

    这篇文章主要为大家详细介绍了vue实现移动端input上传视频、音频,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2020-08-08
  • Vue中使用js-cookie详情

    Vue中使用js-cookie详情

    这篇文章主要介绍了Vue中使用js-cookie详情,文章围绕js-cookie的相关资料展开详细内容具有一定的的参考价值,需要的小伙伴可以参考一下
    2022-03-03
  • vue实现输入一位数字转汉字功能

    vue实现输入一位数字转汉字功能

    这篇文章主要介绍了vue实现输入一位数字转汉字功能,本文通过实例代码给大家介绍的非常详细,具有一定的参考借鉴价值,需要的朋友可以参考下
    2019-12-12
  • 解决Vue 浏览器后退无法触发beforeRouteLeave的问题

    解决Vue 浏览器后退无法触发beforeRouteLeave的问题

    这篇文章主要介绍了解决Vue 浏览器后退无法触发beforeRouteLeave的问题,需要的朋友可以参考下
    2017-12-12
  • Vuex中的Mutation使用详解

    Vuex中的Mutation使用详解

    这篇文章主要介绍了Vuex中的Mutation使用详解,当我们想修改状态值,想传入的值进而进行修改时,你可以向 store.commit 传入额外的参数,即 mutation 的 载荷,需要的朋友可以参考下
    2023-11-11

最新评论