uni-app 的 map 组件 markers 必须是响应式数组，需用 ref 或 reactive 声明；iconPath 必须为 static 目录下的绝对路径；地图需设置有效 center 坐标和 scale 才能显示标记。
直接用 markers 数组绑定，别手动调 addMarkers —— uni-app 的 是响应式组件，改数据它自己重绘。
map 组件的 markers 必须是响应式数组
很多人卡在“点了没反应”或“图标不显示”，根本原因是：markers 没声明为响应式（尤其 Vue3 的 ref 或 reactive 没包住），或者用了非响应式赋值（比如 markers.push() 后没触发更新）。
- Vue2：确保
data()里返回的是对象属性，例如markers: []，后续用this.markers = [...]或this.$set(this, 'markers', [...]) - Vue3（
setup）：必须用ref([])或reactive({ markers: [] })，且更新时要赋新数组，不能只改内部项（除非用markRaw+ 手动触发，不推荐） - 每个 marker 对象至少含
id、latitude、longitude；缺经纬度会导致渲染失败或白点
iconPath 必须是绝对路径，且图片得在 static 目录下
相对路径如 ./images/flag.png 或 @/static/... 全部无效。微信小程序原生地图组件不走 webpack 资源解析，只认真实文件路径。
- 正确写法：
iconPath: '/static/images/marker_active.png' - 错误写法：
iconPath: '@/static/...'、iconPath: '../../static/...'、iconPath: require('...') - 图标尺寸建议设
width/height（单位 px），否则在不同机型上缩放失真
动态更新单个 marker 时，id 是唯一依据，别删再加
想改某个点的图标或气泡内容？别先 removeMarkers 再 addMarkers——这会闪屏、卡顿，还可能清空其他点。uni-app 的 markers 绑定机制支持“同 id 自动覆盖”。
- 确保每次更新都保留原
id字段（类型也要一致，1和"1"被视为不同） - 更新逻辑示例：
markers.value = markers.value.map(m => m.id === targetId ? { ...m, iconPath: newIcon } : m) - 如果接口返回的 marker 数据缺失
id，务必在映射时补上，否则无法匹配更新
地图初始中心点和缩放级别影响 marker 显示
哪怕 markers 数据完全正确，也可能看不见点——因为地图默认中心是 (0, 0)，缩放级别太小，点全在视野外。
- 必须设置
:latitude和:longitude为某个有效坐标（比如用户定位、或第一个 marker 的位置） -
:scale建议设 12–16；太小（如 5）整个中国都挤在屏幕里，点看不见；太大（如 20）可能只显示一幢楼 - 首次渲染前，确保
markers不为空数组，或至少有一个带合法坐标的 marker，否则地图可能不触发重绘
最容易被忽略的是：id 类型一致性、iconPath 的路径硬编码规则、以及地图中心点是否“罩得住”你的标记范围——这三个点错一个，marker 就静默失效，连报错都不会抛。
