watchEffect 必须手动调用返回的 stop 函数终止侦听,防止内存泄漏;推荐在 onUnmounted 中调用,也可在条件判断、异步回调中按需触发,但不可在回调外提前调用。

Vue 3 的 watchEffect 不会自动停止侦听,必须手动调用它返回的 stop 函数 来终止依赖追踪和后续执行。这是防止内存泄漏的关键操作,尤其在异步创建、跨组件复用或非组件上下文中使用时。
获取并调用 stop 函数
每次调用 watchEffect 都会立即返回一个可执行的函数,即 stop:
- 赋值保存:
const stop = watchEffect(() => { console.log(count.value) }) - 手动触发停止:
stop()—— 此后即使count再变化,回调也不会执行 - 可在任意时机调用,包括条件判断、定时器、异步完成回调中
在组件卸载时自动清理
推荐在 onUnmounted 中统一调用 stop,确保组件从 DOM 移除后监听器被释放:
import { onUnmounted } from 'vue'onUnmounted(() => stop())- 若需同步中断副作用(如取消请求、清除定时器),改用
onBeforeUnmount
在回调内条件性停止
适合实现“一次性监听”或状态驱动的终止逻辑,例如达到阈值后退出:
立即学习“前端免费学习笔记(深入)”;
watchEffect(() => { if (counter.value >= 5) stop() })- 注意:不能在回调外层直接写
stop(),否则监听器尚未建立就已终止 - 异步回调中调用前建议加存在性判断:
if (stop) stop()
常见误区与注意事项
以下情况容易导致监听残留或提前失效:
- 未保存返回值(如只写
watchEffect(() => {})),导致无法停止 - 在
setup顶层直接调用stop(),监听器还没启动就终止了 - 监听源来自全局状态、composable 外部或 keep-alive 组件时,自动清理可能不生效
-
deep: true或once: true不改变“需手动调用stop”的本质


















