滚动位置被意外恢复
快速摘要
刷新后页面跳到旧滚动位置——而你的 SPA 期望从顶部开始。
为什么发生
默认 history.scrollRestoration 为 'auto' 会恢复滚动
SPA 刷新期望顶部但浏览器恢复缓存位置
长内容中恢复滚动让用户觉得是 bug
最小示例
✗ 错误代码
// default: history.scrollRestoration === 'auto'
// reload jumps to old scroll position unexpectedly✓ 修复代码
if ('scrollRestoration' in history) {
history.scrollRestoration = 'manual';
}
window.scrollTo(0, 0); // start at top on load浏览器默认恢复滚动。设 scrollRestoration 为 'manual' 把控制权交给 SPA,scrollTo(0,0) 确保从顶部开始。
如何诊断
检查 history.scrollRestoration——若为 'auto' 则浏览器恢复滚动
刷新并观察页面是否跳到非顶部位置
加载时记录 window.scrollY 看恢复值
如何修复
设 history.scrollRestoration = 'manual' 并自行控制滚动
加载时调用 window.scrollTo(0, 0) 从顶部开始
仅对有意义的路由恢复滚动
如何预防
SPA 中设 scrollRestoration 为 'manual' 并显式处理滚动
按路由决定是否需要滚动恢复