flush参数解决回调执行时机问题:'post'在DOM更新后执行,适合操作真实DOM;'pre'为默认值,在更新前执行,适合资源清理;'sync'同步执行,仅限调试等纯副作用场景。

flush 参数解决的核心问题是:数据变了,回调该在 DOM 更新前、更新后,还是立刻执行?它不改变监听逻辑,只调整回调的执行时机——尤其当你需要读取或操作真实 DOM 时,选错就会拿不到最新元素或布局信息。
flush: 'post' —— 操作更新后的 DOM
这是最常用也最安全的选择。回调会在 Vue 完成 DOM 渲染后,在下一个微任务中执行,确保你能访问到最新渲染的节点和布局。
- 适合调用 focus()、scrollIntoView()、getBoundingClientRect() 等依赖真实 DOM 状态的操作
- 行为上接近 nextTick(),但语义更明确,且与 watch 生命周期天然对齐
- 示例:监听搜索关键词,DOM 更新后自动聚焦输入框
watch(searchText, () => {
if (inputRef.value) inputRef.value.focus()
}, { flush: 'post' })
flush: 'pre' —— 默认值,更新前预处理
不写 flush 时,Vue 默认就是 'pre'。回调在组件更新(即 DOM 重绘)之前运行,此时响应式数据已更新,但视图还没刷新。
- 适合清理资源:比如取消未完成的请求、清除定时器、中断动画
- 能拿到最新的 ref.value,但 ref 元素仍指向旧 DOM
- 避免在回调里修改被监听的数据,否则可能触发重复执行或状态不一致
flush: 'sync' —— 同步执行,慎用
回调会随数据变化立刻同步触发,跳过 Vue 的批量更新调度机制。这会破坏默认响应式流程,容易引发问题。
- 可能导致重复执行、渲染撕裂,甚至无限循环(比如在回调里又改了监听源)
- 仅建议用于调试日志、性能埋点等不修改响应式状态的纯副作用
- 业务代码中基本不需要;遇到必须同步的场景,应先检查设计是否合理

















