Vue 3 的 reactive 不适合管理海量地图坐标点,因其 Proxy 深度拦截导致初始化卡顿、内存飙升、交互掉帧;应将坐标存为普通数组,仅对控制变量(如 showHeatmap)做响应式,并借助地图 SDK 原生图层(Canvas/WebGL)高效渲染。

Vue 3 的 reactive 本身不适合直接管理海量地图坐标点(比如几万甚至几十万个点)——不是语法报错,而是性能和响应式机制的根本限制。关键不在于“能不能用”,而在于“该不该用”以及“怎么绕过它的短板”。
为什么 reactive 不适合海量坐标点
Vue 的 reactive 基于 Proxy 深度拦截每个属性的读写。当你把 10 万个点塞进一个 reactive 数组或对象时:
- 初始化过程会触发大量依赖收集,卡顿明显
- 哪怕只改一个点的
lng,Proxy 也会尝试追踪整个结构变化 - 浏览器内存占用飙升,GC 频繁,地图拖拽/缩放掉帧严重
- 实际项目中,用
reactive([{lng:116,lat:39},...])渲染 5 万点,首次渲染常超 2s,且无法流畅交互
正确做法:坐标数据与响应式逻辑分离
把原始坐标数组当作普通 JS 数据(非 reactive),仅对“需要驱动视图更新”的控制变量做响应式。
使用 assistant-ui 构建具有可重用线程、运行时、消息组件和模型/提供者适配器的生产级 React 聊天界面。
-
坐标存 plain array:如
const points = [{lng:116.3,lat:39.9}, ...],不包 reactive -
用 ref 控制开关/状态:如
const showHeatmap = ref(true)、const filterRegion = ref('shanghai') -
地图图层自行管理数据:高德/百度/ECharts 的原生图层(如
AMap.Marker、BMapLib.CanvasLayer、echarts-gl)都支持直接传入原始坐标数组,内部用 Canvas/WebGL 渲染,完全绕过 Vue 响应式系统
需要动态更新时,用最小粒度响应式
如果业务要求点击筛选、实时增删点,不要更新整个数组,而是:
- 用
ref存当前可见点索引集(轻量):const visibleIds = ref(new Set([1,5,88,...])) - 用
computed派生当前要渲染的子集:computed(() => points.filter((p,i) => visibleIds.value.has(i))),但注意:这个 computed 仅用于生成图层参数,不用于存储海量数据本身 - 真正更新图层时,调用地图 SDK 的
setMap或clearOverlays+addOverlay,而非依赖 Vue 重绘
配合 CanvasLayer 或 WebGL 图层更高效
对于 10 万+ 点,推荐放弃 Marker 集合,改用自定义图层:
- 百度地图:用
BMapLib.CanvasLayer,传入points数组,内部用 canvas 逐像素绘制 - 高德地图:用
AMap.CustomLayer或封装CanvasRenderer,pointToPixel转换后 drawImage - ECharts:用
geo+scatter系列,开启large: true和progressive: 1000,它会自动分块渲染
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!









