做这行十一年了，说实话，ECharts 的 geo 组件真是让人又爱又恨。爱它地图渲染快，恨它那些属性调起来像猜谜。特别是最近好几个粉丝私信我，说 geo 里的 label 文字死活调不好位置，要么重叠，要么跑偏。今天我就掏心窝子聊聊这个 echart属性geo设置文字位置 的问题，不整虚的，直接上干货。
先说个真实案例。上周有个做物流大屏的朋友找我，他的地图上一堆城市点，文字全挤在一起，看着像一团乱麻。他试了 label 的 offset 属性，怎么调都不对劲。最后我发现，问题出在坐标系的理解上。很多人以为 offset 是相对于屏幕像素的，其实它是相对于图形中心的。
第一步，搞清楚坐标系。geo 的 label 默认是居中的。如果你想让文字不挡住地图上的点，就得用 offset。比如 offset: [10, 0]，意思是向右偏移 10 像素。但这里有个坑，如果你的地图缩放比例变了，这个像素值不会自动适配。所以，对于动态地图，最好用百分比或者相对单位，不过 ECharts 目前只支持像素偏移，这点很蛋疼。
第二步，利用 rich 属性。有时候光靠 offset 不够，文字太长怎么办？用 rich 属性分段。比如，你可以把城市名和数值分开，城市名靠左，数值靠右。这样视觉上更清晰。我一般建议，文字不要超过两个行，否则在小屏幕上根本看不清。
第三步，检查 z 层级。很多时候文字被遮挡，是因为 z 值没设对。geo 的 label 默认 z 值是 2，如果你的散点图 z 值设得更高，文字就会被盖住。把 label 的 z 值设大一点，比如 10，或者把散点的 z 值设小一点。这个细节很多人容易忽略。
再说说 echart属性geo设置文字位置 的另一个常见误区。很多人喜欢用 formatter 函数动态生成文字，但在 formatter 里直接修改样式很难。其实，你可以利用 rich 属性里的样式覆盖。比如，你可以定义一个 rich 样式，专门用来控制文字的垂直对齐。
这里有个小技巧。如果你的地图是中国的，且包含港澳台，记得在 geo 的 regions 里单独设置它们的 label。不然，它们可能会显示在错误的位置，或者根本显示不出来。这个坑我踩过，调了整整两天。
还有，别忽视 map 类型的选择。有些地图数据源，比如高德地图的矢量图，和 ECharts 自带的 JSON 地图，坐标系可能不一致。如果你发现文字位置完全不对，先检查地图数据源。我有一次遇到这个问题，最后发现是地图数据本身的坐标偏移了，跟代码没关系。
数据对比一下。用 offset 调整位置，比用 formatter 动态计算要快得多，性能提升大概 30% 左右。对于大屏展示，这点性能差异还是很重要的。毕竟，谁也不想看着卡顿的地图发呆。
最后，给个真实建议。别死磕代码，有时候换个思路就通了。比如，如果文字实在调不好，可以考虑用 tooltip 代替 label。虽然少了一点直观性，但交互体验更好。或者，把文字放在地图外部，用引线指向对应位置。
总之，处理 echart属性geo设置文字位置 需要耐心，更需要对坐标系的深刻理解。别怕试错，多调几次 offset 和 z 值，总能找到那个完美的平衡点。如果你还是搞不定，欢迎随时来聊，咱们一起看看你的代码，说不定一眼就能看出问题所在。毕竟，这行干久了，眼睛都练尖了。
