history.scrollRestoration = 'manual' 仅禁用浏览器自动滚动恢复，不控制刷新后位置；需配合 beforeunload 和 pageshow（e.persisted === true）双事件调用 scrollTo(0, 0) 才能可靠回顶。
history.scrollRestoration = 'manual' 本身不能“管理”刷新后的视口锚定，它只做一件事：关掉浏览器自动恢复滚动位置的机制。想让长列表页面在刷新后回到顶部、或保持原位、或跳到某个锚点，必须配合其他手段——否则你只会得到不可控的初始滚动状态。
为什么设成 'manual' 后刷新还是没回顶
因为 scrollRestoration = 'manual' 不等于“强制置顶”，它只是告诉浏览器：“别管我上次滚到哪了，这次别自动恢复”。但页面首次渲染时，window.scrollY 仍可能继承上一次缓存值（尤其 iOS Safari 或 Chrome 的 back/forward cache 场景），或者由系统级滚动恢复策略接管。单纯设为 'manual' 后不加干预，用户刷新很可能看到一个“卡在中间”的错位页面。
- 刷新（F5 / 回车）不是 history 导航，
scrollRestoration对它无直接控制力 -
beforeunload在location.reload()或某些 iOS 版本中可能不触发 - 服务端渲染（SSR）或 hydration 过程中 DOM 尚未就绪，
scrollTo(0, 0)会失效
真正可靠的“刷新后回顶”组合方案
必须用两个事件兜住所有路径：beforeunload 拦普通刷新，pageshow 拦 bfcache 恢复。二者缺一不可。
- 在
beforeunload中同步调用window.scrollTo(0, 0)，确保卸载前视觉已归零（注意：不能用behavior: 'smooth'，该行为在卸载阶段被忽略） - 在
pageshow中判断e.persisted === true，再执行一次window.scrollTo(0, 0)，专治 iOS 后退、Android 内存回收重建等场景 - 务必用
addEventListener注册，避免被框架或第三方脚本覆盖window.onbeforeunload
if ('scrollRestoration' in window.history) {
window.history.scrollRestoration = 'manual';
}
window.addEventListener('beforeunload', () => {
window.scrollTo(0, 0);
});
window.addEventListener('pageshow', (e) => {
if (e.persisted) {
window.scrollTo(0, 0);
}
});
如果目标是“刷新后回到上次位置”，别碰 scrollRestoration
scrollRestoration = 'manual' 是反向开关——它禁用恢复，不是开启存储。想实现“回到上次阅读位置”，得自己存、自己取、自己滚：
- 用
localStorage.setItem('scroll-' + location.pathname, window.scrollY)在离开前记录位置（建议在beforeunload或路由守卫中） - 在新页面 DOM 就绪后（如
DOMContentLoaded或 Vue 的onMounted、React 的useEffect），读取并window.scrollTo({ top: pos, behavior: 'auto' }) - 恢复后立刻
localStorage.removeItem()，防止跨路由污染 - 移动端要额外监听
visibilitychange，因 iOS Safari 可能跳过beforeunload
虚拟列表或动态渲染下特别容易失效的点
长列表常配合虚拟滚动或分页加载，此时 window.scrollTo() 的目标 offset 可能因 DOM 异步渲染而错位：
- 不要在
DOMContentLoaded就执行恢复滚动——此时真实列表项可能还没挂载 - 应在数据加载完成、列表 DOM 真实渲染完毕后触发，比如 React 中用
useLayoutEffect，Vue 中用nextTick().then(() => scrollTo()) - 若用 IntersectionObserver 做懒加载，需等所有可视区域内容渲染完再恢复，否则
scrollTo会滚到一个“空高度”的位置 -
body上若有overflow: hidden或height: 100vh类样式，会干扰window.scrollTo的生效容器，优先检查document.scrollingElement是否为document.documentElement
最易被忽略的是：bfcache 场景下 beforeunload 根本不触发，只靠它永远防不住 iOS Safari 的“刷新错位”。pageshow + e.persisted 这个判断条件，不是可选项，是必填项。
