简单来说,v-once 是在编译阶段直接冻结的静态优化,v-memo 则是运行时有条件地记忆化渲染。前者更彻底——永久跳过响应式追踪和虚拟 DOM diff;后者依靠依赖数组的浅比较来决定子树是否需要重新渲染。

这两个指令是 Vue 3 中轻量且高效的渲染优化工具——不改变业务逻辑,只在虚拟 DOM 更新阶段精准刹车,让不需要重新渲染的部分彻底跳过 diff 和 patch 流程。
v-once:静态内容的硬性冻结
它并非缓存机制,而是一个编译期标记。Vue 编译器会将带有 v-once 的节点识别为静态节点,直接提升为模块级常量 vnode。后续所有更新周期中,该节点都会被直接复用,完全绕过三项操作:响应式依赖收集(不触发 effect)、虚拟节点 diff 对比(不进入 patchElement)、真实 DOM 操作(不调用 insert/remove/setAttribute)。
最适合的场景是页脚版权声明、协议文本、固定导航栏、图标组件这类真正永不变化的内容。需要特别注意的是:一旦使用 v-once,后续数据即使变化,界面也不会更新。所以切勿在需要动态响应的字段上滥用,否则会形成静态死结。
v-memo:带条件的子树记忆化
v-memo 是运行时决策,通过依赖数组控制是否跳过子树更新。每次更新前,Vue 会对传入的数组(例如 v-memo="[id, status]")做一次浅比较:
- 所有依赖项相等 → 复用旧的 vnode,整个子树的 diff 和 patch 全部跳过
- 任一依赖项不等 → 正常渲染,同时更新缓存数组
它并不阻止响应式追踪,子组件内部依然能正常响应数据变化,它只控制“这一整段结构是否需要重新计算”。特别适合列表项、表格行、实时行情卡片这类局部稳定但整体高频更新的场景,有效提升 Vue 渲染性能。
关键区别与使用提醒
v-once 相当于“拍快照”,v-memo 则是“看条件决定是否复用”。两者语义完全不同,不能混用在同一个元素上。切忌将 v-memo="[]" 当作 v-once 来使用——虽然功能上等价,但表达的是“无依赖需检查”,而非“我永久不变”。
几个实用的避坑建议:
- v-once 不接受参数,v-memo 必须传入一个固定长度、语义明确的数组(比如使用 item.id 而非 item 本身)
- 避免将对象引用、undefined 或函数返回值作为 v-memo 的依赖项,否则浅比较会失效
- 这两个指令均不影响首次渲染速度,只减少后续更新的开销
它们并非万能灵药——但在恰当的场景中,能让高频更新的页面始终保持流畅顺滑的体验。
