Watch 停止侦听怎么调用 watch 返回的停止函数(stop handle)手动注销侦听器

轻辰同学_7261

轻辰同学_7261

2026-08-29

692人浏览

原创

watch 和 watcheffect 均返回可调用的 stop 函数,用于手动停止侦听;需保存返回值并在适当时机(如 onunmounted)调用,多次调用幂等但仅首次生效。

watch 停止侦听怎么调用 watch 返回的停止函数(stop handle)手动注销侦听器

在 Vue 中,watch 返回的停止函数(stop handle)用于手动注销侦听器,防止内存泄漏或避免在组件卸载后仍执行回调。调用它很简单:直接执行该函数即可。

如何获取并调用 stop 函数

使用 watch(尤其是组合式 API 的 watch)时,它会立即返回一个函数,调用它就能停止侦听:

  • 在 setup 或 onMounted 等钩子中调用 watch,保存其返回值
  • 在需要时(如组件卸载前、条件变化时)执行该函数

示例:

import { watch, onUnmounted } from 'vue'

const stopWatch = watch(source, (newVal, oldVal) => {
  console.log('值变了', newVal)
})

// 手动停止侦听(比如在某个逻辑分支里)
// stopWatch()

// 推荐:在组件卸载时自动清理
onUnmounted(() => {
  stopWatch()
})

watchEffect 也适用相同方式

watchEffect 同样返回可调用的 stop 函数,用法一致:

Vuejs
Vuejs

Vue.js 官方推荐通过 npm 进行安装,这是构建现代化前端项目最主流的方式。在终端中执行 npm install vue 即可获取最新稳定版,如需指定版本可添加 @版本号,例如 npm install vue@3.4.0。安装前请确保已配置 Node.js 环境(推荐 v18 及以上版本),并建议将 npm 镜像源切换至国内镜像以提升下载速度。对于大型项目,还可通过 npm create v

下载
  • 它会自动追踪响应式依赖,无需显式指定 source
  • 返回的函数调用后,不再响应后续变化

示例:

import { watchEffect, onUnmounted } from 'vue'

const stop = watchEffect(() => {
  console.log('count:', count.value)
})

// 需要时手动停止
// stop()

onUnmounted(stop) // 直接传入,更简洁

注意点:stop 函数只能调用一次

Vue 的 stop 函数是幂等的,多次调用不会报错,但第二次起不再起作用:

  • 调用一次后,侦听器彻底失效,后续数据变化不会触发回调
  • 不需要担心重复调用导致异常,但也不建议无谓多次调用
  • 不要在已 stop 的 watch 上再次尝试读取或重用它

不推荐:依赖 watch 的“自动清理”而不手动 stop

虽然 Vue 3 在组件卸载时会自动清理 watch 和 watchEffect,但在以下场景必须手动调用 stop:

  • 侦听器创建在组件外部(如工具函数、全局逻辑中)
  • 需提前终止监听(例如用户取消操作、切换 tab、关闭弹窗)
  • 同一响应式数据被多个 watch 监听,只停其中某一个

不复杂但容易忽略 —— 记住:拿到返回值,用到就调,不用就 onUnmounted 里清。

相关专题

更多
vue2.0和3.0区别
vue2.0和3.0区别

vue2.0和3.0区别:vue2的响应式原理是利⽤“Object.defineProperty()”对数据进⾏劫持结合发布订阅模式的⽅式来实现,vue3中使⽤了es6的proxy API对数据代理,实现对数据的监控。本专题为大家提供vue2.0和3.0区别的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.17

1674

5

vue3的生命周期有哪些
vue3的生命周期有哪些

vue3的生命周期:1、beforecreate;2、created;3、beforemount;4、mounted;5、beforeupdate;6、updated;7、beforedestroy;8、destroyed;9、activated;10、deactivated等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

12042

5

Vue3组合式API与组件开发实战
Vue3组合式API与组件开发实战

本专题讲解 Vue 3 组合式 API 的核心概念与应用技巧,深入分析响应式系统、生命周期管理、组件设计与复用策略。通过完整项目案例,指导前端开发者实现高性能、结构清晰的 Vue 应用,提升开发效率与代码可维护性。

2026.02.10

316

23

PixTV官网入口地址合集
PixTV官网入口地址合集

本专题汇总了 PixTV AI 一站式视频创作平台的官方入口与使用教程。无需下载软件,浏览器直接访问即可使用。平台将剧本、图像、视频、声音与剪辑整合在“无限画布”中,接入 GPT Image 2.5、Seedance 2.5 等头部模型。本专题整理了从新建画布、角色锚定、分镜拆分到视频生成与导出的完整操作指南,助你快速上手 AI 短剧与漫剧创作。

2026.10.10

100

15

Kratos框架HTTP与gRPC服务开发教程
Kratos框架HTTP与gRPC服务开发教程

本专题围绕Kratos框架双协议服务开发,涵盖HTTP路由与处理器编写、参数获取、gRPC服务实现与客户端调用、metadata上下文传递、encoding编解码注册、统一响应封装、超时控制与流式响应实现方法。

2026.10.10

40

15

Kratos框架Protobuf接口定义与代码生成合集
Kratos框架Protobuf接口定义与代码生成合集

本专题讲解Kratos框架接口定义体系,涵盖proto编写规范、proto add/client/server生成命令、http注解路由、validate校验、OpenAPI文档生成、跨服务proto复用与兼容性设计。

2026.10.10

20

15

C++虚函数怎么定义和调用
C++虚函数怎么定义和调用

C++虚函数是实现运行时多态的重要机制。本专题从virtual关键字的基本用法入手,介绍基类与派生类之间的函数重写、基类指针调用派生类方法,以及动态绑定的执行过程,帮助初学者掌握虚函数的核心语法。

2026.10.10

40

26

C++类与对象的封装方法教程
C++类与对象的封装方法教程

C++封装是面向对象编程的核心特性之一,通过类将数据与操作数据的函数组织在一起,并利用访问权限控制外部访问。本专题介绍类的定义、成员变量、成员函数以及public、private和protected的使用方法,帮助初学者掌握封装的基本原理。

2026.10.10

40

32

C++构造函数定义与调用方法
C++构造函数定义与调用方法

C++构造函数用于初始化类对象,是面向对象编程的重要基础。本专题从构造函数的定义、声明和调用入手,介绍默认构造函数、带参数构造函数、拷贝构造函数及成员初始化列表,帮助初学者掌握对象创建与初始化的基本方法。

2026.10.10

40

16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Vue 教程
Vue 教程

共42课时 | 17.1万人学习

国外Web开发全栈课程全集
国外Web开发全栈课程全集

共12课时 | 1.4万人学习

Vue.js 微实战--十天技能课堂
Vue.js 微实战--十天技能课堂

共18课时 | 1.7万人学习