history.scrollRestoration 是控制浏览器是否在历史导航或刷新时自动恢复滚动位置的属性，值为 'auto'（默认，自动恢复）或 'manual'（禁用自动恢复，需手动滚动）；它为只读属性，无法通过赋值 'auto' 重新启用自动恢复，一旦设为 'manual' 即永久生效且不可逆。
scrollRestoration 是什么，为什么不能直接赋值为 'auto'
history.scrollRestoration 是一个只读属性，你无法通过 history.scrollRestoration = 'auto' 来开启滚动恢复。浏览器默认是 'auto'，但某些场景（比如 SPA 路由切换后手动调用 history.pushState() 或 replaceState()）会触发浏览器将其隐式设为 'manual'，导致刷新后丢失滚动位置。
真正能控制行为的，是是否在页面生命周期中调用过 history.scrollRestoration = 'manual' —— 一旦设过，后续刷新就不再自动滚动回原位置，且该设置无法重置为 'auto'（只读属性不允许写入）。
如何检查并避免被意外设为 'manual'
很多前端路由库（如早期版本的 Vue Router、React Router v5 的某些自定义 scroll behavior 实现）会在初始化或导航时执行类似 history.scrollRestoration = 'manual' 的语句，只为接管滚动逻辑。但这个操作是一次性的“污染”，之后即使卸载路由库也无法还原。
- 打开 DevTools → Console，输入
history.scrollRestoration，确认当前值是'auto'还是'manual' - 全局搜索项目代码中是否出现
scrollRestoration = 'manual'，尤其是router.beforeEach、useEffect初始化块、或第三方插件的源码 - 若发现有，注释掉或升级到支持自动恢复的版本（如 React Router v6.4+ 默认不干预 scrollRestoration）
刷新后想保持滚动位置，光靠 scrollRestoration 不够
scrollRestoration 只决定“浏览器是否尝试恢复”，但恢复效果还依赖两个前提：页面必须是同一 URL 下的软刷新（即 history state 未被清空），且 document.body 有足够高度支撑该 offset。
- 硬刷新（F5 / 地址栏回车）通常能恢复，前提是没设过
'manual'，且页面 DOM 加载完成后 scrollY 才被重置 - 如果页面首屏渲染慢（例如 SSR 内容少、JS 加载延迟），浏览器可能在 DOM 尚未撑开时就执行了滚动，结果滚到顶部又“掉下来”
- 解决办法不是改
scrollRestoration，而是监听pageshow事件，在event.persisted === true时手动window.scrollTo()
示例：
window.addEventListener('pageshow', (e) => {
if (e.persisted) {
// 确保 body 已渲染出足够高度
setTimeout(() => {
window.scrollTo(0, sessionStorage.getItem('scrollY') || 0);
}, 100);
}
});
// 记录退出前位置（可选，作为 fallback）
window.addEventListener('beforeunload', () => {
sessionStorage.setItem('scrollY', window.scrollY.toString());
});
Chrome 和 Safari 对 scrollRestoration 的实际表现差异
Chrome 90+ 基本遵循规范：设过 'manual' 后，即使页面重载也跳过恢复；而 Safari（尤其 iOS）对 scrollRestoration 的支持更弱，有时忽略设置，有时仅在往返缓存（bfcache）生效，但禁用 bfcache 后行为不可控。
- iOS Safari 中，
scrollRestoration几乎无实际作用，必须依赖pageshow+sessionStorage方案 - Android Chrome 中，设为
'manual'后，即使页面内location.reload()也不会恢复，但新开 tab 访问同 URL 仍会恢复（因为是全新 history entry） - 不要在
document.readyState !== 'complete'时读写window.scrollY，iOS 下可能返回 0
最稳妥的做法，是放弃依赖 scrollRestoration 的自动机制，统一用 pageshow 捕获 + setTimeout 延迟滚动，同时注意 iOS 下 scrollTo 的兼容性（避免传对象语法，用 scrollTo(x, y) 形式）。
