scrollBehavior在新DOM渲染完成但未激活前调用,通过读取当前scrollTop捕获用户最后视图位置;返回{x:0,y:0}滚动到顶、{selector:'#id'}滚动到元素、null不滚动、Promise可异步控制。

scrollBehavior 不是在路由跳转“完成时”才执行,而是在新页面 DOM 渲染完成、但尚未激活(即未触发 mounted 或 updated)前的过渡阶段被调用。它之所以能准确记录滚动位置,关键在于 Vue Router 的内部调度机制与浏览器原生 API 的协同时机控制。
滚动位置记录发生在离开守卫之后、DOM 替换之前
当用户触发导航(如点击 router-link 或调用 router.push),Vue Router 会按序执行:
- 先运行 beforeRouteLeave 等离开守卫
- 然后暂停 DOM 更新,准备新组件实例
- 在新组件挂载前、旧组件卸载后,立即调用 scrollBehavior
- 此时 document.scrollingElement.scrollTop(或 window.pageYOffset)仍反映的是当前页面的最终滚动位置
也就是说,它捕获的是“用户最后看到的视图位置”,而非跳转后的空白页初始位置。
scrollBehavior 返回值如何影响实际滚动行为
该函数返回的对象或 Promise 决定了后续滚动动作的触发方式和目标:
- { x: 0, y: 0 } → 路由切换后立即滚动到顶部(适用于列表页回退到首页)
- { selector: '#main' } → 查找匹配元素并滚动其顶部对齐视口(需确保元素已存在于新 DOM 中)
- null → 不做任何滚动(保留上一次位置,常用于详情页返回列表页时维持滚动锚点)
- Promise → 可异步等待数据加载或 DOM 就绪后再滚动(例如等 v-for 渲染完再 scrollIntoView)
浏览器原生滚动状态的可靠性保障
Vue Router 并不自行“记忆”滚动坐标,而是依赖浏览器在页面切换间隙中保持的原生状态:
- 在 history 模式下,popstate 事件触发前,页面尚未重绘,scrollTop 值有效
- 在 hash 模式或编程式导航中,Router 在 nextTick 或 requestAnimationFrame 微任务中读取 scrollY,避开布局抖动
- 对 keep-alive 缓存组件,scrollBehavior 会结合 savedPosition(由 Router 内部在 deactivate 钩子中保存)还原位置
常见误区:为什么有时滚动没生效?
不是 scrollBehavior 写错了,而是时机或上下文不匹配:
- 返回 { selector: '.item' },但该元素在新组件 mounted 后才通过 API 渲染 → 应配合 async/await + nextTick 等待 DOM 就绪
- 使用 keep-alive 但未给组件设置唯一 key → savedPosition 无法正确映射,导致复用时滚动错乱
- 在 iOS Safari 中,document.scrollingElement 可能为 null → 推荐统一用 window.scrollY 或 window.pageYOffset










