干了十二年 GIS 和前端可视化，我见过太多人死在 echarts geo map 这个坑里。真的，别觉得这是个小问题。很多新手照着官方文档抄代码，结果地图一片空白，或者坐标乱飞，心态直接崩盘。今天我不讲那些虚头巴脑的理论，就聊聊我踩过的雷，和怎么快速让地图动起来。

先说个真事。上周有个做物流的朋友找我，说他的 echarts geo map 怎么都渲染不出来。我一看代码，好家伙，JSON 数据源用的是 2010 年的旧版，坐标体系还是 WGS84，但他后端给的数据是 GCJ02。这能显示才怪呢。这就好比你去北京，结果导航把你导到了纽约，除了方向感，其他全是错的。

所以，第一步，搞清坐标系。这是最基础的，也是最容易忽略的。国内大部分业务数据，尤其是涉及地图展示的，大概率是 GCJ02 或者 BD09。如果你直接用 WGS84 的 GeoJSON 去套，那地图肯定偏移。别问为什么，问就是国情。

第二步，找对数据源。网上那些免费的 GeoJSON 下载站，很多都过时了。我一般推荐去阿里云 DataV 或者高德地图开放平台找。虽然官方文档里也有示例数据，但那个只是为了演示，边界粗糙得很。你要是做精细化的业务展示，比如精确到街道，那必须得自己处理数据。别省这个功夫，否则后期改 Bug 的时间够你喝三杯咖啡。

第三步，配置项里的 series 别瞎填。很多教程里直接复制粘贴 series 配置，也不看 type 是 'map' 还是 'scatter'。如果是 echarts geo map，记得要把 map 属性对应到你的 GeoJSON 里的 name 字段。这里有个小细节，很多 JSON 里的地名是全称，比如“北京市”，而你数据里可能只写了“北京”。这会导致匹配失败，地图上那一块就是白的。这时候，你得在 series 里加个 nameProperty 属性，或者在预处理数据时统一格式。

再说说性能问题。有些朋友为了追求效果，把全国几百个地级市的数据全塞进去，结果页面卡成 PPT。记住，echarts 虽然强大，但也不是万能的。如果数据量超过几千个点，考虑用 canvas 模式，或者简化多边形。我有个案例，之前一个项目，用了十万个点做热力图，加载时间长达 5 秒。后来我把数据聚合到区级粒度，加载时间降到 0.5 秒，用户体验反而更好。毕竟，用户在乎的是趋势，不是每一个小区的细节。

还有，样式美化别过度。很多开发者喜欢把地图颜色搞得花里胡哨，红红绿绿的，看着头晕。其实，简洁才是高级。用低饱和度的背景色，突出数据层。比如，背景用深灰，数据用橙色渐变。这样既专业，又不会抢了数据的戏。

最后，调试技巧。别光盯着控制台报错，很多时候报错信息很模糊。你可以先用 console.log 打印出你的 GeoJSON 数据，看看结构对不对。再打印 series 配置，看看 map 属性是否匹配。有时候，就是一个逗号漏了，或者引号用了中文，都能让你抓狂半天。

总之，做 echarts geo map 不难，难的是细节。别指望一次成功，多试几次，多查查文档。遇到坑，别慌，先检查数据源，再检查坐标系，最后检查配置项。这三步走下来，90% 的问题都能解决。

希望这些经验能帮你少走弯路。毕竟，时间就是金钱，把时间花在刀刃上，比在那儿瞎折腾强多了。加油吧，同行们。