MKMapView刷新单个标注触发全地图重载跳动的解决方法

问题背景 #

在MKMapView扩展中实现标注重载逻辑时，采用「先移除标注、再重新添加标注」的写法，会触发全地图标注视图重排，导致所有图钉出现重载跳动效果，即使包裹UIView.performWithoutAnimation也只能减弱动画、无法完全消除全局影响。目标是实现仅刷新单个标注，不触发全地图重载的视觉异常。
原有问题代码：

func reloadAnnotation(_ annotation: MKAnnotation, keepSelection: Bool = true) {
    let isSelected = selectedAnnotations.contains(where: annotation.isEqual(_:))
    // 已尝试UIView.performWithoutAnimation，仅能减弱跳动无法根治
    // UIView.performWithoutAnimation {
      self.removeAnnotation(annotation)
      self.addAnnotation(annotation)
    // }
    guard isSelected && keepSelection else {
        return
    }
    self.selectedAnnotations.append(annotation)
}

实现方案 #

彻底放弃「移除+重添加」的刷新思路，直接对目标标注对应的视图做单点更新，完全不会触发其他标注的重绘：

• 对可见区域内的标注，通过MKMapView.view(for:)方法直接获取对应的MKAnnotationView实例，该接口不会触发任何全局的标注重排逻辑
• 直接修改标注视图的属性（如图标、副标题、气泡样式等），自定义标注视图可以直接调用自定义的数据绑定方法更新内容
• 修改完成后调用标注视图的setNeedsLayout()、setNeedsDisplay()触发局部重绘即可，影响范围仅限当前标注
• 若标注实现MKAnnotation协议时，coordinate、title、subtitle等属性设置为可写，直接修改这些属性后，MapKit会自动更新对应标注的默认展示内容，无需手动操作视图

优化后的实现代码：

func reloadAnnotation(_ annotation: MKAnnotation, keepSelection: Bool = true) {
    let isSelected = selectedAnnotations.contains(where: annotation.isEqual(_:))
    
    // 标注不在可见区域时无需刷新，后续滚动到可视范围时MapKit会自动拉取最新内容
    guard let annotationView = self.view(for: annotation) else { return }
    
    // 在此处编写标注视图的更新逻辑，例：
    // annotationView.image = UIImage(named: "updated_marker")
    // 自定义标注可调用自身的刷新方法，如 (annotationView as? CustomPinView)?.updateUI()
    annotationView.setNeedsLayout()
    annotationView.setNeedsDisplay()
    
    // 兜底保留选中状态，正常视图更新不会丢失选中状态
    if isSelected && keepSelection, !annotationView.isSelected {
        self.selectAnnotation(annotation, animated: false)
    }
}

注意：不要通过操作selectedAnnotations数组直接追加元素的方式设置选中，应该调用selectAnnotation(_:animated:)官方接口，避免选中状态异常。

内容的提问来源于stack exchange，提问作者user19406372