v-memo 是 Vue 3 提供的一个性能优化工具，能帮助开发者缓存模板内容，减少不必要的渲染开销。本文将介绍 v-memo 的引入版本、作用、使用方法和实现原理，并通过示例说明如何使用它。内容基于 Vue 3.5.18（截至 2025 年 7 月的最新版本），各位前端同胞过过眼就好。

一、`v-memo` 是什么？哪个版本引入？

1. 引入版本

v-memo 在 Vue 3.2.0（2021 年 8 月发布）中首次亮相，是 Vue 3 编译器优化的新特性，专为提升渲染性能设计。

2. 作用

v-memo 用于缓存模板的子树，通过传入一个固定长度的依赖数组，只有当数组中的值发生变化时，包裹的 DOM 子树才会重新渲染。其核心优势包括：

减少渲染开销：跳过静态或低频变化内容的重复渲染。
优化复杂场景：特别适合大型列表、表格或包含复杂计算的模板。
灵活控制：相比 v-once 的完全静态化，v-memo 能根据依赖动态决定是否更新。

它类似于 React 的 React.memo，但作用于模板片段，粒度更细，适合微优化。

适用场景：

静态 UI（如页头、页脚）。
大型 v-for 列表（例如超过 1000 项）vue官方建议。
包含耗时计算（如 computed 属性）的模板。

二、如何使用 `v-memo`

1. 基本用法

v-memo 需要一个固定长度的 依赖数组（类型：any[]），只有数组中的值变化时，Vue 才会重新渲染包裹的模板内容。如果依赖不变，渲染将完全跳过，甚至虚拟 DOM 的 VNode 创建也会被省略。

<template><div v-memo="[valueA, valueB]"><!-- 只有 valueA 或 valueB 变时，这部分才会重新渲染 --><p>{{ content }}</p></div>
</template>

注意：

正确指定依赖数组至关重要，漏掉关键依赖可能导致更新被错误跳过。
传入空数组（v-memo="[]"）等同于 v-once，模板只渲染一次。

2. 示例：优化静态内容

以下示例展示如何用 v-memo 优化包含复杂计算的静态内容。

<template><div><button @click="count++">点我加1：{{ count }}</button><div v-memo="[staticValue]"><p>静态内容：{{ staticValue }}</p><p>复杂计算：{{ expensiveComputed }}</p></div></div>
</template><script setup>
import { ref, computed } from 'vue'const count = ref(0)
const staticValue = ref('固定内容')// 模拟耗时计算
const expensiveComputed = computed(() => {console.log('跑了一次复杂计算')return staticValue.value + ' - 计算结果'
})
</script><style scoped>
button {padding: 8px 16px;background: #409eff;color: white;border: none;border-radius: 4px;cursor: pointer;margin-bottom: 16px;
}
div {padding: 10px;background: #f5f5f5;border-radius: 4px;
}
</style>

运行效果：

点击按钮增加 count 会触发父组件渲染，但因为 staticValue 未变，v-memo 包裹的 <div> 及其子内容不会重新渲染。
expensiveComputed 仅在初次渲染或 staticValue 变化时运行，控制台只打印一次“跑了一次复杂计算”。

3. 示例：搭配 `v-for` 优化大型列表

v-memo 在渲染海量 v-for 列表时特别有用。以下示例展示如何优化列表项的渲染。

<template><div><button @click="selected = selected === 1 ? 2 : 1">切换选中：{{ selected }}</button><ul><li v-for="item in list" :key="item.id" v-memo="[item.id === selected]"><p>ID：{{ item.id }} - 选中：{{ item.id === selected }}</p><p>更多内容...</p></li></ul></div>
</template><script setup>
import { ref } from 'vue'const selected = ref(1)
const list = ref([{ id: 1, name: 'Item 1' },{ id: 2, name: 'Item 2' },{ id: 3, name: 'Item 3' },
])
</script><style scoped>
button {padding: 8px 16px;background: #409eff;color: white;border: none;border-radius: 4px;cursor: pointer;margin-bottom: 16px;
}
ul {list-style: none;padding: 0;
}
li {padding: 10px;background: #f5f5f5;border-radius: 4px;margin-bottom: 8px;
}
</style>

说明：

每个列表项的 v-memo="[item.id === selected]" 确保只有当 item.id === selected 的值变化时，该项才会重新渲染。
item.id 不需加入依赖数组，因为 Vue 会根据 :key 自动处理列表项的复用。
当 selected 变化时，只有受影响的列表项会更新，其他项复用缓存的 VNode，跳过 diff 和渲染。

4. 注意事项

依赖数组准确性：依赖数组必须包含所有影响渲染的变量，否则可能导致更新被错误跳过。

与 v-for 的搭配：v-memo 和 v-for 需绑定在同一元素上，且不能在 v-for 内部使用 v-memo。

<!-- 正确 -->
<li v-for="item in list" :key="item.id" v-memo="[item.id === selected]">...</li>
<!-- 错误 -->
<ul v-for="item in list" :key="item.id"><li v-memo="[item.id === selected]">...</li>
</ul>

响应式依赖：依赖项需为 ref、reactive 或 computed 值，确保响应式追踪生效。
子组件限制：v-memo 只控制模板渲染，子组件内部逻辑可能仍需单独优化。
空依赖数组：v-memo="[]" 等同于 v-once，仅渲染一次。

三、`v-memo` 的实现原理

1. 工作流程

v-memo 结合 Vue 3 的编译器和响应式系统，实现高效的渲染缓存：

模板解析：
- 编译器识别 v-memo 指令，为包裹的模板生成特殊渲染逻辑。
- 依赖数组被解析为响应式依赖，类似 watchEffect 的依赖收集。
依赖追踪：
- 依赖数组中的值由 Vue 3 的 Proxy 响应式系统监控。
- 依赖变化时，Vue 标记该 DOM 子树需要更新。
VNode 缓存：
- 初次渲染生成 v-memo 包裹子树的 VNode（虚拟 DOM 节点）。
- 依赖不变时，Vue 复用缓存的 VNode，跳过 diff 和 DOM 更新。
更新机制：
- 依赖变化时，Vue 生成新 VNode，执行 diff 算法更新 DOM。
- 子组件的更新逻辑不受 v-memo 控制，需单独优化（如 defineAsyncComponent）。

2. 与 `v-once` 的区别

v-once：只渲染一次，之后完全静态，忽略所有数据变化。
v-memo：根据依赖数组动态决定是否渲染，适合半静态场景。

3. 底层细节

响应式系统：依赖 Vue 3 的 Proxy 实现精确的依赖追踪。
编译器优化：为 v-memo 节点添加 PatchFlags，运行时跳过不必要的 diff。
性能提升：通过缓存 VNode 和减少 DOM 操作，显著降低复杂场景的开销。

四、适用场景与优化建议

1. 适用场景

静态 UI：页头、页脚、固定文本。
大型列表：超过 1000 项的 v-for 列表，优化未选中项的渲染。
复杂计算：包裹耗时的 computed 或复杂模板逻辑。

2. 优化建议

精确依赖：只列出影响渲染的变量，避免多余更新。
搭配 v-for：在列表项上使用 v-memo，结合 :key 优化。
其他优化手段：
- 用 defineAsyncComponent 异步加载子组件。
- 大数据量场景搭配虚拟列表（如 vue-virtual-scroller）。
- 使用 keep-alive 缓存动态组件。
调试技巧：用控制台日志检查依赖变化，确保 v-memo 行为符合预期。