必须调用 dispose() 销毁 echarts 实例并置空引用;resize 监听需具名函数并在 onunmounted 中移除;keep-alive 下需在 ondeactivated/onactivated 中分层清理;初始化前校验 dom,销毁前确认未 disposed,避免重复 init。

确认 ECharts 实例存在再销毁
不能只写 chartInstance = null,这不会释放内存。必须调用 dispose() 方法,且要先判断实例是否真实存在,避免重复调用报错:
- 检查
chartInstance是否为有效对象(非null、undefined、false) - 调用
chartInstance.dispose(),这是 ECharts 官方指定的销毁入口 - 销毁后手动置空引用:
chartInstance = null,辅助 GC 回收
解绑全局事件监听器
ECharts 常配合 window.resize 自动适配尺寸,但该监听器绑定在全局对象上,组件卸载后仍会触发,干扰其他页面:
ECharts 图表大师。根据用户数据和业务上下文,自动设计并生成专业的 ECharts 可视化图表。使用场景:(1) 用户提供表格/JSON/CSV 数据需要可视化,(2) 用户说"帮我做个图"、"画个图表",(3) 需要将查询结果可视化展示。
- 绑定时使用具名函数(不能用箭头函数或匿名函数),确保
removeEventListener能精准匹配 - 在
onUnmounted中显式调用window.removeEventListener('resize', handler) - 若多个图表共用同一 resize 处理器,注意避免误删其他组件的监听
处理 keep-alive 场景下的额外清理
大屏项目常启用 <keep-alive></keep-alive>,此时 onUnmounted 可能不触发。仅靠它不够,需分层管控:
- 在
onDeactivated中提前执行chartInstance?.dispose()和window.removeEventListener - 在
onActivated中检查是否存在已有实例(echarts.getInstanceByDom(dom)),有则复用或先dispose再init -
onUnmounted作为最终兜底:再次检查并销毁,防止缓存失效后残留
避免 DOM 引用残留和重复初始化
图表容器 DOM 元素被移除后,ECharts 实例若还持有其引用,会导致内存泄漏:
- 初始化前确保
chartRef.value存在且为有效 DOM 节点 - 销毁前确认
chartInstance?.isDisposed === false,防止对已销毁实例重复调用dispose - 禁用无脑重 init:不要在数据更新或路由切换时直接
echarts.init(dom),先查实例、再处置、再新建










