滚动记忆的核心目标是用户离开页面再返回时保持上次滚动位置，Vue 3 中通过 useScrollPosition 组合式函数封装读取、保存、恢复逻辑，并协同路由 scrollBehavior 与 key 策略实现稳定记忆，辅以边界降级处理。
滚动记忆的核心目标
用户离开页面再返回时，保持上次浏览的滚动位置，避免从顶部重新加载。这在列表页、详情页跳转后回退等场景中非常关键。Vue 3 中不依赖路由守卫硬编码，而是通过组合式函数封装通用逻辑，让任意页面可一键接入。
useScrollPosition：基础状态与同步机制
封装一个 useScrollPosition 组合式函数，负责读取、保存和恢复滚动偏移量。它不绑定具体 DOM 元素，而是默认监听 window，同时支持传入容器 ref 以适配局部滚动场景（如 el-table-body、自定义 scrollable 区域）。
- 用 ref(0) 管理当前滚动位置，并在 onMounted 中从 sessionStorage 或 localStorage 读取历史值
- 使用 watchEffect 监听滚动事件，防抖后写入存储（避免高频触发）
- 在 onActivated（keep-alive 场景）或 onMounted 后调用 scrollTo 恢复位置，注意加 nextTick 确保 DOM 渲染完成
- 对局部滚动容器，需确保其 overflow-y: auto/scroll 且有明确高度，否则 scrollTop 不生效
与路由深度集成：key + scrollBehavior 协同
仅靠组件内逻辑不够稳定——比如用户手动刷新页面，或从其他路径进入该页面。需配合 Vue Router 的 scrollBehavior 配置：
Springboot Vue Builder
下载
从零开始编排 SpringBoot+Vue 全栈项目工作流，适用于新建全栈项目或完整脚手架请求，触发后依次调用 product‑spec‑builder（需求调研）等模块。
- 为每个需要记忆的路由设置唯一 scrollKey（如
user-list、order-detail-123） - 在 scrollBehavior 中优先读取该 key 对应的缓存位置，fallback 到组件内 useScrollPosition 的值
- 若使用 keep-alive，建议给 router-view 添加 key 属性（如
:key="$route.fullPath"），避免组件复用导致状态错乱
边界处理与降级策略
真实项目中需应对多种异常情况：
立即学习“前端免费学习笔记（深入）”；
- 页面内容高度变化（如图片加载完成、折叠面板展开）：恢复滚动后立即检测 scrollTop > scrollHeight - clientHeight，若超出则重置为底部
- 存储容量限制或失效：用 try/catch 包裹读写逻辑，失败时静默降级为不记忆
- SSR 场景下 window 未定义：在 onMounted 内初始化，服务端跳过所有 DOM 操作
- 移动端 Safari 的滚动弹性行为可能导致 scrollTo 偏移：可加 { behavior: 'auto' } 避免动画干扰恢复精度
