shallowRef 优化大列表的核心是避免深度响应式代理,只监听数组引用变化;需用 shallowRef([]) 初始化、批量修改后调用 triggerRef(),并配合虚拟滚动控制渲染节点数。

在 Vue 3 中,用 shallowRef 优化移动端 H5 大列表的核心逻辑很直接:**避免对成百上千项数据做深度响应式代理,只监听整个数组引用是否被替换**。这对滚动卡顿、点击响应慢、内存占用高这三类典型 H5 问题效果显著。
为什么大数组用 ref 会拖慢移动端?
Vue 3 的 ref([]) 会对数组里每个对象(如 { id, name, avatar })递归转为响应式——哪怕你只展示文本、不修改状态。iOS WebView 或低端安卓机上,初始化 2000 条数据可能触发数万次 Proxy 拦截和依赖收集,造成首屏白屏或卡顿 1–2 秒。
- ref 对每个 item 都创建 getter/setter,内存占用翻倍
- 每次
list.push(item)或list[0].status = 'done'都触发全量 diff - 移动端 JS 主线程更紧张,响应式开销更容易暴露
shallowRef 的正确用法(含关键细节)
把大数组交给 shallowRef,等于告诉 Vue:“我只关心这个数组是不是换了个新引用,内部怎么变,你别管”。但必须配合两个动作才能兼顾功能与性能:
- 用
shallowRef([])初始化列表,而非ref([]) - 批量修改后调用
triggerRef()主动通知更新(不能靠赋值触发) - 禁止直接改
list.value[i].xxx后期待自动刷新——它不会发生
示例代码:
立即学习“前端免费学习笔记(深入)”;
import { shallowRef, triggerRef } from 'vue'
// ✅ 正确:大型列表走 shallowRef
const tableData = shallowRef([])
// ✅ 批量操作:先改内部,再统一触发
function batchUpdateStatus(ids, newStatus) {
tableData.value.forEach(item => {
if (ids.includes(item.id)) {
item.status = newStatus
item.updatedAt = Date.now()
}
})
triggerRef(tableData) // ? 唯一一次更新,不卡顿
}
// ❌ 错误:这样写不会更新视图
// tableData.value[0].status = 'active'
配合虚拟滚动进一步提效
shallowRef 解决的是响应式开销,但若一次性渲染全部 DOM 节点(比如 5000 行),仍会阻塞主线程。建议组合使用:
- 用
shallowRef管理原始数据源 - 用
computed计算当前可视区域的子集(如visibleList = computed(() => data.slice(start, end))) - 模板中只遍历
visibleList,而非全量tableData.value
这样既保留了数据完整性,又让渲染节点数稳定在 20–50 个,滚动丝滑度接近原生 App。
注意事项与边界场景
不是所有大数组都适合 shallowRef。需确认以下三点:
- 列表项基本是只读展示,或修改集中在少数字段且可批量处理
- 没有频繁监听某一项的某个嵌套属性变化(例如
watch(() => item.detail.count)) - 不依赖第三方库(如 Element Plus Table)内部对响应式深度变更的自动感知——它们通常只认
.value引用变化
如果业务强依赖单条数据的细粒度响应(如实时协作编辑),应改用 shallowReactive + markRaw 包裹不可变字段,或拆分响应式层级。



















