vue3使用keep-alive组件,包含动态组件使用详解
Vue3中keep-alive用于缓存组件状态并避免重复渲染。动态组件需使用markRaw或shallowRef避免响应式警告。keep-alive内不能有注释，否则报错。路由缓存需在component上使用v-if实现按需缓存，被缓存组件会触发activated/deactivated生命周期钩子。
vue3使用keep-alive组件，包含动态组件使用详解
在 Vue 3 项目中，keep-alive 几乎是缓存组件状态、避免重复渲染的标配方案。但很多开发者在实际使用中总会遇到一些奇怪的坑——比如动态组件缓存不生效、路由缓存莫名其妙地失效，或者报出“expects exactly one child component”这类让人摸不着头脑的错误。下面就从最基础的无缓存开始，一步步搭起完整的缓存体系，顺带把这些容易翻车的地方也一并点出来。
组件不使用keep-alive
先看一个最简单的例子：父组件通过 v-if/v-else 切换两个子组件，不添加任何缓存。
- Father
Fatherchange page
- Child
Child + {{ props.msg }}
- Child2
Child2 + {{ props.msg }}
每次点击按钮切换，对应的子组件都会被销毁并重新创建。如果子组件中有表单输入之类的状态，切换回来时数据就丢了。因此需要 keep-alive 来保持组件的“记忆”。
组件中使用
keep-alive 提供了两个常用的配置：
include：指定需要缓存的组件名（对应组件name选项）exclude：排除掉不需要缓存的组件
v-if切换
先看直接包裹 v-if/v-else 的情况：
这样两个组件都会被缓存。如果只想缓存其中的一个，可以利用 include：
此时只有 Child2 会被缓存，Child 每次切换都会重新创建。
component动态组件切换
因注释导致的意外错误
使用动态组件 component :is 时，经常会遇到一个报错：
expects exactly one child component
这个错误原因很简单——keep-alive 内部只能有一个直接子节点，而注释（HTML comment）会被当作一个虚拟节点，导致实际子节点变成了两个。比如下面这样就会报错：
解决方案有两种：要么用 动态组件的使用 如果直接用 [Vue warn]: Vue received a Component which was made a reactive object. This can lead to unnecessary performance overhead, and should be a voided by marking the component with 'markRaw' or using 'shallowRef' instead of 'ref'. 原因在于组件本身不应该被包装成响应式对象——只有组件的 props 和内部状态才需要响应。正确的做法是使用 完整示例 运行后可以看到，只有 路由场景下的缓存稍微复杂一些。先看没有缓存的写法： 和组件级一样，每次路由切换，页面组件都会被销毁重建，表单状态自然也就丢失了。 Vue Router 4（对应 Vue 3）引入了 在路由配置中，通过 这样，只有 被 利用这两个钩子，可以在组件被缓存或重新激活时做一些订阅/取消订阅、数据刷新等操作，非常实用。 以上就是 Vue 3 中使用 WPS Office是一款面向macOS用户的综合办公套件，将文字处理、电子表格、演示文稿、PDF工具、模板与云协作整合在同一应用中。它兼容常见Microsoft Office格式，支持Intel及Apple芯片Mac，基础功能可免费使用， Shapr3D是一款面向工业设计、机械工程、建筑概念和三维打印工作流的CAD软件。Mac版采用Parasolid建模内核，支持草图约束、实体建模、工程图、可视化渲染及常见CAD格式交换，并可通过账户在多台设备之间同步项目。 REAPER是Cockos开发的数字音频工作站，提供多轨音频与MIDI录制、剪辑、处理、混音和母带制作工具。Mac版兼容Intel与Apple芯片，支持AU、VST、VST3、CLAP等插件格式，并提供高度可定制的工作流程。 Ableton Live 是面向音乐制作人与现场表演者的数字音频工作站，提供编曲视图、独具特色的现场视图、音频录制、MIDI创作、实时变速、乐器及效果器。Mac版原生支持Apple芯片，并可连接音频接口、MIDI控制器和第三方插件。 Adobe After Effects 是面向动态图形、影视特效与视频合成的专业创作软件。它提供关键帧动画、遮罩抠像、运动跟踪、三维空间、文字动画和表达式等工具，并可与 Premiere Pro、Photoshop、Illustrator Adobe Audition 是面向播客、影视后期、音乐制作及内容创作者的专业音频工作站，提供波形精修、多轨录制与混音、频谱编辑、降噪修复、响度匹配和效果处理工具，并可与 Adobe Premiere 协同完成视频声音制作。 Adobe Bridge 是面向摄影师、设计师及内容团队的免费数字资产管理工具，可集中预览照片、视频和 Adobe 项目文件，并利用评级、标签、关键词、元数据、筛选与收藏集完成分类检索。它还支持批量重命名、格式导出、相机导入及 Camera Adobe Illustrator 是 Adobe 推出的专业矢量图形设计软件，适合在 Mac 上制作标志、图标、插画、包装、信息图及印刷版面。它以路径和锚点构建可无损缩放的图形，并提供钢笔、形状、文字、图像描摹、渐变、画板及生成式功能。 Adobe InDesign 是面向印刷品与数字出版物的专业版面设计软件，可在 Mac 上制作书籍、杂志、宣传册、海报、报告及交互式文档。它提供精细的文字样式、网格、母版、长文档管理和印前输出能力。 Adobe Lightroom Classic 是面向桌面摄影工作流的照片管理与后期处理软件，可将原始照片保存在本地硬盘，通过目录、关键词、评分和收藏夹高效整理图库，并提供 RAW 冲印、蒙版、镜头校正、批量同步及多格式导出等功能。 Adobe Media Encoder 是 Adobe 推出的专业音视频编码与转码工具，可通过队列、预设和监视文件夹批量完成格式转换、代理文件创建及多平台成片输出，并与 Premiere Pro、After Effects 等软件紧密协作。 Adobe Photoshop 是面向摄影师、设计师和内容创作者的专业图像处理软件，提供图层、蒙版、选区、修复、调色、文字排版、智能对象及生成式编辑等能力。Mac 版支持 Intel 与 Apple Silicon 处理器。 Adobe Photoshop 是面向摄影师、设计师和内容创作者的专业图像处理工具，可在 Windows 上完成照片修饰、选区抠图、图层合成、文字排版、绘画及生成式编辑。软件采用订阅授权，由 Creative Cloud 管理安装、更新与许 Adobe InDesign 是面向印刷与数字出版的专业页面排版工具，可制作书籍、杂志、宣传册、海报、交互式 PDF 和电子书。它提供精细的文字样式、多页面管理、印前检查及多格式输出能力，并能与 Photoshop、Illustrator Adobe Illustrator 是用于绘制矢量图形、插画、图标、徽标和版式的专业设计工具。它以路径和锚点为核心，作品放大后仍能保持清晰，并提供画板、文字、渐变、图像描摹及精确变换等功能，适合品牌视觉、印刷物料、数字界面和商业插画创作。 Adobe Bridge 是 Adobe 推出的创意资产管理工具，可集中预览、分类和查找照片、视频、PDF及多种设计文件，并支持元数据、关键词、评级、批量重命名和格式导出。它可与 Photoshop、Illustrator 等应用衔接， Affinity Photo 是一款面向摄影师、修图师和视觉设计人员的桌面图像编辑工具，提供 RAW 显影、多图层合成、蒙版、实时滤镜、批处理和色彩管理等功能。原独立产品已停止销售，其照片编辑能力已延续至免费的新 Affinity 应用； Adobe Lightroom Classic 是面向 Windows 桌面摄影工作流的照片管理与无损编辑工具，可通过目录集中整理大型图库，并完成 RAW 显影、局部蒙版、批量调整、打印和多格式导出。它强调本地文件管理与精细控制， Figma 是面向产品设计与开发团队的云端协作平台，可在 Windows 桌面客户端中完成界面绘制、组件管理、交互原型、评论评审和开发交付。文件保存在云端，多名成员能够同步编辑并共享设计系统；官方同时提供免费 Starter 方案及按席位计 Affinity Designer 是面向矢量图形、数字插画和界面设计的专业创作工具，可在矢量、像素与导出工作区之间快速切换。它提供曲线编辑、形状构建、画板、排版、图层和专业色彩管理，并支持常见设计文件的导入及多种印刷、网页格式输出。 Capture One Pro 是面向摄影师和影像团队的专业桌面照片处理工具，提供相机定制色彩配置、RAW转换、图层与蒙版、联机拍摄、目录及会话管理等功能。它适合棚拍、人像、商业产品、婚礼和风光摄影， Adobe Acrobat Pro 是面向专业 PDF 工作的综合解决方案，可在 Windows 中创建、编辑、转换、比较、整理和保护文档，并支持表单、电子签名、扫描件文字识别及敏感信息永久遮盖。订阅还包含网页、移动服务和云端协作能力， Adobe After Effects 是面向动态图形、动画与影视视觉特效制作的专业工具，可完成关键帧动画、图层合成、遮罩跟踪、抠像、文字动画和二维三维元素整合。Windows 版通过 Adobe Creative Cloud 安装及更新， DaVinci Resolve是Blackmagic Design推出的一体化影视后期工具，将素材管理、非线性剪辑、专业调色、Fusion视觉特效、Fairlight音频处理和成片交付整合在统一工程中。免费版已覆盖多数个人创作需求，
ref 或 reactive 来保存组件引用，Vue 会发出警告：
markRaw 或 shallowRef：
markRawconst com = ref(markRaw(Child2));const comChange = () => { if(com.value === Child2){ com.value = markRaw(Child); }else{ com.value = markRaw(Child2); }}
shallowRefconst com = shallowRef(Child2);const comChange = () => { if(com.value === Child2){ com.value = Child; }else{ com.value = Child2; }}
Child2 组件有缓存行为（生命周期中会触发 activated/deactivated），Child 每次切换都会经历销毁和重新创建。
路由不使用keep-alive
import { createRouter, createWebHashHistory, createWebHistory } from 'vue-router'import Home from '@/views/Home.vue'const routes = [ { path: '/Father', name: 'Father', component: () => import('@/views/Father.vue'), children: [ { path: 'Child', name: 'Child', component: () => import('@/views/Child.vue'), }, { path: 'Child2', name: 'Child2', component: () => import('@/views/Child2.vue'), } ], }, ]const router = createRouter({ history: createWebHashHistory(), routes})export default router
路由中使用
v-slot API，可以方便地实现路由级别的缓存。这里有一个关键点：v-if 不能加在 keep-alive 上，否则直接销毁整个缓存容器；正确的做法是将 v-if 放在内部 component 上，实现按需缓存。
meta 属性标记哪些页面需要缓存：...const routes = [ { path: '/Father', name: 'Father', component: () => import('@/views/Father.vue'), children: [ { path: 'Child', name: 'Child', component: () => import('@/views/Child.vue'), }, { path: 'Child2', name: 'Child2', meta: { keepAlive: true, // 需要被keep-alive }, component: () => import('@/views/Child2.vue'), } ], }, ]...
keepAlive: true 的路由页面会被缓存，其他页面正常销毁。页面进入时触发的生命周期顺序为：created → mounted → activated。
keep-alive生命周期
keep-alive 包裹的组件会额外多出两个生命周期钩子，分别在 mounted 之后和 unMounted 之前触发：onActivated(() => { console.log('Component is activated')})onDeactivated(() => { console.log('Component is deactivated')})
总结
keep-alive 的完整实战指南，涵盖了组件内和路由层面的缓存方案，同时也指出了几个容易踩坑的地方——比如 keep-alive 内不能有注释、动态组件引用要用 markRaw 或 shallowRef、路由缓存的 v-if 要加在内部组件上等等。掌握这些细节后，缓存问题基本可以一次搞定，希望能在实际项目中帮上忙。
