Leaflet-Geoman Pro 中 addVertexOnClick 与 limitMarkersToCount 的兼容性问题分析

Leaflet-Geoman Pro 作为 Leaflet 的高级绘图插件扩展，提供了比免费版更丰富的功能和性能优化选项。在实际使用过程中，开发者发现当同时启用 addVertexOnClick 和 limitMarkersToCount 这两个功能时，会出现顶点添加事件触发异常的情况。

问题现象

当开发者在专业版中同时配置了以下两个选项时：

• addVertexOnClick: true（允许通过点击线段直接添加顶点）
• limitMarkersToCount: true（限制标记点数量以优化性能）

此时如果用户直接在折线/多边形上点击添加顶点，虽然 pm:vertexAdded 事件会被触发，但事件对象(event)却变成了 undefined 状态。这种异常行为会导致依赖于该事件的后续操作无法正常执行。

技术背景

功能特性解析

addVertexOnClick 是 Geoman 提供的一项便捷功能，允许用户无需先选择编辑模式，直接在线段上点击即可添加新的顶点。这大大提升了编辑效率，特别适合需要频繁修改几何形状的场景。

limitMarkersToCount 是 Pro 版特有的性能优化选项，它会限制当前显示的标记点数量，只渲染视口中可见的或特定数量的标记点。这对于处理大型复杂几何图形时能显著提升渲染性能。

底层机制差异

在免费版中，这两个功能的组合使用是完全正常的。问题仅出现在专业版中，这表明 Pro 版的性能优化逻辑可能对事件传递机制产生了某些副作用。特别是当限制标记点数量时，系统可能没有正确处理新增顶点的完整生命周期。

解决方案

根据仓库维护者的确认，此问题将在下一个 Geoman Pro 版本中得到修复。对于当前遇到此问题的开发者，可以考虑以下临时解决方案：

1. 暂时禁用 limitMarkersToCount 选项，牺牲部分性能换取功能完整性
2. 使用其他事件如 pm:edit 作为替代方案来监测几何图形变化
3. 在事件处理函数中添加对 event 参数的判空处理，增强代码健壮性

最佳实践建议

在使用 Geoman Pro 的高级功能时，建议开发者：

• 仔细测试各功能组合的兼容性
• 关注官方更新日志，及时升级到修复版本
• 对关键事件处理函数添加防御性编程，避免因参数异常导致整个应用崩溃
• 在性能与功能之间做好平衡，根据实际场景选择适当的优化选项

该问题的修复将进一步提升 Geoman Pro 在复杂地理编辑场景下的稳定性和可靠性，使开发者能够更放心地利用其强大的绘图和编辑功能构建专业级地理信息系统应用。