v-memo 是 Vue 3.2+ 的轻量级渲染优化指令,依赖数组全未变时跳过子树 diff 和 patch,直接复用 VNode;需传入固定长度数组做浅比较,适用于长列表项、仪表盘区块等静态子树场景,须配合显式 key 使用。

v-memo 是 Vue 3.2+ 引入的轻量级渲染优化指令,作用是在依赖未变时跳过整棵子树的 diff 和 patch,直接复用上次生成的 VNode。它不改变响应式逻辑,也不阻止父组件更新,只在虚拟 DOM 更新阶段“按需跳过”。
怎么写 v-memo 指令
语法很简单:在任意元素或组件上添加 v-memo,传入一个数组表达式,数组中列出该子树是否需要刷新的“触发条件”:
- 数组必须是静态长度,不能动态增减项
- 数组内每个值都会做浅比较(
===),任一变化即触发重渲染 - 不能单独使用——Vue 3.4+ 要求必须配合
v-for,否则会警告;3.2–3.3 版本可独立使用,但建议统一加key - 示例:...
哪些地方适合加 v-memo
核心判断标准:子树节点多、更新频率低、但被父组件高频更新波及。常见适用场景包括:
- 长列表中每一项里相对静态的部分(比如用户头像、昵称区域,仅当
user.name或user.avatar改变才更新) - 仪表盘中某个固定区块,只依赖几个配置字段(如
theme、timezone) - 表单区块中不随输入变化的内容(例如标题、说明文字、只读字段)
- 插槽中明确不会响应当前更新的数据部分(配合
外层包裹)
使用时要注意什么
v-memo 不是万能开关,用错反而导致更新失效或内存浪费:
- 避免把响应式对象整个放进去(如
v-memo="[user]"),应拆解为基本类型字段(user.id、user.status) - 计算属性可以放,但要确保它本身是稳定返回(避免每次返回新对象/数组)
- 空数组
v-memo="[]"效果等同于v-once,整块内容只渲染一次,后续永不更新 - 务必搭配显式
key使用,尤其在v-for中,否则可能引发 key 冲突或复用错误
和 v-once、KeepAlive 的区别
三者目标都是减少渲染开销,但机制和粒度不同:
-
v-once:一次性渲染,之后完全冻结,连 props 变化也不响应 -
v-memo:有条件地跳过,依赖变就正常更新,适合“大部分时间静止、偶尔更新”的子树 -
:缓存整个组件实例(含状态、生命周期、DOM),适合频繁切换但需保留现场的场景(如标签页)
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










