还在死磕dojox.geo.openlayers？这坑我踩了三年，真不想再提

说实话，看到现在还有人问 dojox.geo.openlayers 这玩意儿，我心里真有点五味杂陈。不是因为它难，而是因为它太“老”了，老到像是我前男友送的那件起球的毛衣，扔了可惜，穿着扎人。

我入行做GIS开发快十年了，前五年基本都在跟Dojo Toolkit打交道。那时候觉得Dojo强大啊，组件齐全，逻辑严密。特别是那个 dojox.geo.openlayers 模块，当年可是我们项目的核心。记得2016年左右，我们接了一个国土规划的大项目，甲方非要实时叠加矢量数据，还要做复杂的拓扑分析。那时候ArcGIS JS API 3.x虽然流行，但授权费贵得离谱，我们为了省预算，硬着头皮用Dojo搭架子，套上OpenLayers做底图渲染。

那段时间，加班是常态。为什么？因为 dojox.geo.openlayers 的文档简直是一场灾难。官方文档更新滞后，很多API接口描述含糊不清，遇到Bug只能去翻源码，或者去Stack Overflow上碰运气。我记得有次做图层切换动画，怎么调都不流畅，最后发现是Dojo的Event模块和OpenLayers的渲染循环打架了。为了解决这个问题，我硬是啃了两天源码，改了几个核心类的监听逻辑，才勉强跑通。那种感觉，就像是在修一辆没有图纸的老爷车，全靠手感。

现在回头看，用 dojox.geo.openlayers 做项目，最大的痛点就是维护成本太高。随着浏览器版本的迭代，很多旧API早就失效了，但没人去管。比如那个 dojo/_base/lang 里的 mixin 方法，现在都用ES6的Object.assign了，但在老项目里还得硬用。还有，OpenLayers的版本升级也是个坑，OL3、OL4、OL5，每次升级都伴随着大量的代码重构。如果你现在接手一个老项目，里面还藏着 dojox.geo.openlayers 的代码，那你做好掉几根头发的准备了。

当然，也不是说它一无是处。在特定的内网环境，或者对浏览器兼容性要求极低（比如只支持IE9+）的老系统里，它依然能跑。而且，Dojo的模块化思想其实挺超前的，只是生态没跟上。

我有个朋友，去年接手了一个类似的遗留系统，甲方要求加个新功能，结果发现核心逻辑全绑在 dojox.geo.openlayers 的自定义控件上。他想重构，但甲方预算不够，只能打补丁。最后花了三个月，写了一堆hack代码才搞定。他说，那三个月过得比坐牢还难受。

所以，给想入行或者正在用这套技术栈的朋友几个真心话。第一，如果是新项目，千万别碰Dojo和 dojox.geo.openlayers 的组合。真的，听劝。现在Leaflet、Mapbox GL JS、甚至OpenLayers 6+都足够好用，文档友好，社区活跃，遇到问题搜一下就有答案。第二，如果是维护老项目，别想着彻底重写，除非你有足够的预算和时间。先摸清业务逻辑，再一点点剥离Dojo的依赖。第三，别迷信“大而全”的框架，有时候简单的库反而更稳定。

技术选型这东西，就像找对象，合适最重要，别光看名气。我见过太多人为了炫技或者跟风，选了不适合的技术栈，最后把自己坑惨了。

如果你现在正被 dojox.geo.openlayers 折磨得睡不着觉，或者手头有个老项目不知道咋下手，别硬扛。可以找我聊聊，我不一定能手到病除，但能帮你避几个坑，省点头发。毕竟，这行干久了，大家都挺不容易的。

本文关键词：dojox.geo.openlayers