搞地图可视化，最烦的不是画饼图，而是那个geo组件死活不显示或者显示错位。这篇东西，就是专门治各种“地图不加载”、“坐标对不上”、“数据乱飞”的疑难杂症，看完你就不用再对着控制台发呆找bug了。

我干这行七年了，见过太多刚入行的小兄弟，拿着百度地图API那一套思维去搞ECharts，结果碰壁碰得头破血流。ECharts的geo，说白了就是个披着地图外衣的矢量图组件。它不依赖外部地图服务，它依赖的是你给它的geojson数据。很多人报错，90%是因为geojson格式不对，或者坐标系没搞对。

记得去年给一个做物流轨迹的客户做大屏，需求很简单，就是在全国地图上打点，显示各个仓库的库存热力。客户那边给了个geojson文件，说是从某个开源项目扒下来的。我直接丢进option里，好家伙，地图缩成了一团黑线，或者干脆是一片空白。调试了一下午，最后发现那个geojson里的坐标系是WGS84，而ECharts默认期望的是CGCS2000或者百度坐标系（取决于你引用的地图库）。这就像你拿着美国的尺子去量中国的布，能对齐才怪。

这里说个真事儿，有个做电商数据的朋友，想搞个省份销量排行地图。他直接在option里写了个geo，然后填了个简单的经纬度数组。结果呢？点全跑到太平洋去了。为啥？因为ECharts的geo组件，如果你不指定projection或者坐标系转换，它默认认为你给的数据就是屏幕像素坐标或者特定的投影坐标。你要是直接扔经纬度，它真就按经纬度当像素画了。

解决这个问题的核心，就在于怎么正确地进行 echarts option给geo赋值 。

第一，数据源要干净。别信网上那些随手下载的geojson，很多里面多边形是断开的，或者坐标顺序反了。我自己一般用高德或者百度的API下载器，把省份或者城市的边界数据导出来，然后自己写个脚本校验一下拓扑关系。虽然麻烦点，但省得后期改bug改到怀疑人生。

第二，坐标转换是重头戏。如果你的数据源是标准的经纬度，一定要用ECharts提供的coordTransform库，或者自己在数据预处理阶段做个转换。别指望ECharts能自动帮你把WGS84转成百度坐标，它没那么智能。我之前的一个项目，为了搞这个坐标转换，专门封装了一个工具函数，把原始数据批量处理成ECharts能识别的格式。这一步做好了，后面就顺风顺水。

第三，样式配置别太花哨。很多新手喜欢给geo加各种渐变、阴影、边框，结果性能直接崩盘。地图渲染是吃CPU的，尤其是数据量大的时候。我建议，先把基础样式调好，确保地图能正常显示，再考虑美化。比如，设置itemStyle的areaColor为浅灰色，borderColor为白色，borderWidth为1，这样既清晰又不卡。

再说说那个让人头秃的 tooltip。有时候地图显示了，但鼠标移上去没反应。这通常是因为geo的regions配置里，name和geojson里的name对不上。ECharts是严格匹配字符串的，少一个空格都不行。我有个同事，因为geojson里有个城市叫“北京市”，而数据里写的是“北京”，结果死活匹配不上。后来把数据清洗了一遍，统一了命名规范，问题才解决。

最后，提醒一句，别把geo和series搞混了。geo是底图，series是上面的数据点或线。很多错误是因为把series的配置写进了geo里，或者反过来。记住，geo只管地图长啥样，series管数据怎么展示。

搞技术就是这样，坑一个接一个，但填坑的过程最爽。当你看到地图上那些数据点精准地落在对应的城市中心，那种成就感，比喝杯奶茶强多了。希望这些经验能帮你在 echarts option给geo赋值 的路上少踩点坑，早点下班。