Vue / 系统课时
页面缓存与滚动行为
页面缓存与滚动行为
页面缓存的目标不是“让页面永远不销毁”,而是让用户返回列表、表单或详情页时,保留合适的组件实例、滚动位置和数据状态,同时确保刷新后仍能从路由与接口恢复页面。这里给出一套可控的 KeepAlive、缓存键、滚动恢复与刷新策略。
学习目标
- 用路由元信息控制哪些页面进入
KeepAlive,并选择稳定的缓存键 - 配置 Vue Router 的滚动恢复,区分返回导航与普通跳转
- 设计软刷新、重新激活与浏览器硬刷新的数据恢复策略
先确定缓存边界
KeepAlive 缓存的是组件实例,不是整个浏览器页面。适合缓存列表筛选结果、分页位置、未提交的轻量 UI 状态;登录态、关键业务数据或必须实时刷新的服务端状态,不应只依赖组件缓存。

下面是 App.vue 的片段示例,依赖已经安装并注册 Vue Router,且需要缓存的路由都具有唯一 name。
<template>
<RouterView v-slot="{ Component, route }">
<KeepAlive :max="10">
<component
v-if="route.meta.keepAlive"
:is="Component"
:key="route.name"
/>
</KeepAlive>
<component
v-if="!route.meta.keepAlive"
:is="Component"
:key="route.name"
/>
</RouterView>
</template>预期结果:标记 keepAlive: true 的页面离开后进入最多 10 个实例的缓存池,再次返回时优先复用原实例;未标记的页面按普通路由组件处理。
不要默认用 route.fullPath 做缓存键。查询参数频繁变化时,它会为同一业务页面创建大量缓存实例。通常使用 route.name;只有确实要按某个业务标识拆分缓存时,才把必要的 params 拼入键中。
配置滚动恢复
Vue Router 的 scrollBehavior 能可靠处理“普通跳转回顶部”和“浏览器前进后退恢复位置”两个主场景。下面是 router/index.ts 的片段示例,路由数组可替换为项目自己的配置。
import { createRouter, createWebHistory } from 'vue-router'
declare module 'vue-router' {
interface RouteMeta {
keepAlive?: boolean
}
}
export const router = createRouter({
history: createWebHistory(),
routes: [
{
path: '/orders',
name: 'orders',
component: () => import('../views/OrdersPage.vue'),
meta: { keepAlive: true },
},
{
path: '/orders/:id',
name: 'order-detail',
component: () => import('../views/OrderDetailPage.vue'),
},
],
scrollBehavior(to, _from, savedPosition) {
if (savedPosition) return savedPosition
if (to.hash) return { el: to.hash, top: 64 }
return { top: 0 }
},
})预期结果:浏览器后退或前进时优先恢复历史滚动位置;新进入页面时滚到顶部;带锚点的地址滚到目标元素,并为固定头部保留 64 像素偏移。实际滚动距离会随页面高度而不同。
页面重新激活时刷新数据
缓存页再次出现会触发 onActivated。它适合做“数据过期才刷新”,而不是每次激活都无条件请求。下面是 OrdersPage.vue 的片段示例,假设 fetchOrders 返回订单数组。
<script setup lang="ts">
import { onActivated, onMounted, ref } from 'vue'
type Order = { id: string; status: string }
const orders = ref<Order[]>([])
const loading = ref(false)
const loadedAt = ref(0)
async function fetchOrders(): Promise<Order[]> {
const response = await fetch('/api/orders')
if (!response.ok) throw new Error(`HTTP ${response.status}`)
return response.json() as Promise<Order[]>
}
async function load(): Promise<void> {
if (loading.value) return
loading.value = true
try {
orders.value = await fetchOrders()
loadedAt.value = Date.now()
} finally {
loading.value = false
}
}
async function refreshIfStale(): Promise<void> {
if (Date.now() - loadedAt.value > 30_000) {
await load()
}
}
onMounted(load)
onActivated(refreshIfStale)
</script>预期结果:首次进入页面加载数据;30 秒内从缓存返回时直接复用现有状态,超过 30 秒再请求接口。真实请求地址、响应字段与过期时间应按项目约定调整。
区分软刷新与硬刷新
软刷新应优先重新请求当前页面数据,而不是粗暴重建整个应用。硬刷新会清空 KeepAlive 与其他内存状态,因此页面必须能仅凭 URL、持久化会话和后端接口重新构造。
对于表单草稿或筛选条件,要先判断它们是否应该跨刷新存在:应该共享或可收藏的筛选条件放入 query;只在当前访问周期有效的状态留在组件;需要跨页面长期复用的业务状态交给 Pinia,并独立设计持久化与失效规则。
当缓存键稳定、滚动恢复与导航类型匹配,并且缓存页有明确的重新取数条件时,页面体验才会同时具备“返回快”和“数据可信”两个特征。