SwiftUI下MKMapView添加5000个标注卡顿，求优化方案

针对5000个标注导致的地图交互卡顿问题，除了你已经采用的聚类、视图复用方案，还可以通过以下优化进一步提升性能，实现流畅交互：

1. 修正聚类ID不一致问题 #

现有代码中自定义标注视图的聚类ID重复设置且不统一，会干扰系统的聚类逻辑，导致不必要的视图重建。

修改代码： #

更新CustomMKMarkerAnnotationView，统一聚类ID：

import MapKit

class CustomMKMarkerAnnotationView: MKMarkerAnnotationView {
    static let ReuseId = "customAnnotation"
    static let ClusterId = "annotationCluster" // 统一聚类标识
    
    override init(annotation: MKAnnotation?, reuseIdentifier: String?) {
        super.init(annotation: annotation, reuseIdentifier: reuseIdentifier)
        clusteringIdentifier = Self.ClusterId
    }
    
    required init?(coder aDecoder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }
}

移除MapViewCoordinator中重复设置聚类ID的代码：

// 删除此行：annotationView.clusteringIdentifier = CustomMKMarkerAnnotationView.ReuseId

2. 异步创建标注，避免阻塞主线程 #

在主线程批量创建5000个标注会阻塞UI初始化，将标注创建逻辑移到后台线程，完成后再回到主线程添加：

修改MapView的makeUIView方法： #

func makeUIView(context: Context) -> MKMapView {
    mapView.register(MKMarkerAnnotationView.self, forAnnotationViewWithReuseIdentifier: MapViewCoordinator.clusterReuseId)
    mapView.register(CustomMKMarkerAnnotationView.self, forAnnotationViewWithReuseIdentifier: CustomMKMarkerAnnotationView.ReuseId)
    mapView.delegate = context.coordinator
    
    // 后台线程创建标注，主线程添加
    DispatchQueue.global(qos: .background).async {
        var annotations = [MKPointAnnotation]()
        for _ in 0...5000 {
            let annotation = MKPointAnnotation()
            annotation.title = "Test"
            annotation.coordinate = CLLocationCoordinate2D(latitude: Double.random(in: 50...52), longitude: Double.random(in: 0...2))
            annotations.append(annotation)
        }
        DispatchQueue.main.async {
            self.mapView.addAnnotations(annotations)
        }
    }
    
    return mapView
}

3. 优化标注视图的配置逻辑 #

将视图配置从mapView(_:viewFor:)移到prepareForDisplay方法中，该方法在视图即将显示时触发（包括复用场景），减少重复操作开销：

创建自定义聚类视图： #

import MapKit

class ClusterMarkerAnnotationView: MKMarkerAnnotationView {
    static let ReuseId = "cluster"
    
    override func prepareForDisplay() {
        super.prepareForDisplay()
        guard let cluster = annotation as? MKClusterAnnotation else { return }
        glyphText = String(cluster.memberAnnotations.count)
        markerTintColor = .systemBlue
        canShowCallout = false
    }
}

更新MapView的注册逻辑： #

// 替换原聚类视图注册代码
mapView.register(ClusterMarkerAnnotationView.self, forAnnotationViewWithReuseIdentifier: ClusterMarkerAnnotationView.ReuseId)

简化MapViewCoordinator的viewFor方法： #

func mapView(_ mapView: MKMapView, viewFor annotation: MKAnnotation) -> MKAnnotationView? {
    if annotation is MKUserLocation { return nil }
    
    if let cluster = annotation as? MKClusterAnnotation {
        return mapView.dequeueReusableAnnotationView(withIdentifier: ClusterMarkerAnnotationView.ReuseId, for: cluster)
    }
    
    guard annotation is MKPointAnnotation else { return nil }
    return mapView.dequeueReusableAnnotationView(withIdentifier: CustomMKMarkerAnnotationView.ReuseId, for: annotation)
}

4. 减少地图渲染负载 #

关闭不必要的地图元素，降低渲染压力：

func makeUIView(context: Context) -> MKMapView {
    // ... 其他代码
    
    // 关闭建筑物、POI显示
    mapView.showsBuildings = false
    mapView.showsPointsOfInterest = false
    
    // iOS 13+ 使用矢量地图优化渲染
    if #available(iOS 13.0, *) {
        let config = MKStandardMapConfiguration()
        config.renderingMode = .vectorStandard
        mapView.preferredConfiguration = config
    }
    
    // ... 其他代码
}

5. 改用轻量标注视图（可选） #

如果不需要MKMarkerAnnotationView的气泡样式，改用更轻量的MKAnnotationView，减少视图渲染开销：

import MapKit

class CustomAnnotationView: MKAnnotationView {
    static let ReuseId = "customAnnotation"
    static let ClusterId = "annotationCluster"
    
    override init(annotation: MKAnnotation?, reuseIdentifier: String?) {
        super.init(annotation: annotation, reuseIdentifier: reuseIdentifier)
        clusteringIdentifier = Self.ClusterId
        image = UIImage(systemName: "mappin.circle.fill")
        tintColor = .red
    }
    
    required init?(coder aDecoder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }
}

在MapView中注册该视图即可替换原标注视图。

6. 动态加载可见区域标注（进阶优化） #

如果5000个标注仍带来压力，可只加载当前地图可见区域内的标注，动态更新：

更新MapView： #

struct MapView: UIViewRepresentable {
    let mapView: MKMapView = MKMapView(frame: .zero)
    @State private var allAnnotations = [MKPointAnnotation]()
    
    func makeCoordinator() -> MapViewCoordinator{
        MapViewCoordinator(self)
    }
    
    func makeUIView(context: Context) -> MKMapView {
        mapView.register(ClusterMarkerAnnotationView.self, forAnnotationViewWithReuseIdentifier: ClusterMarkerAnnotationView.ReuseId)
        mapView.register(CustomMKMarkerAnnotationView.self, forAnnotationViewWithReuseIdentifier: CustomMKMarkerAnnotationView.ReuseId)
        mapView.delegate = context.coordinator
        
        // 后台创建所有标注
        DispatchQueue.global(qos: .background).async {
            var annotations = [MKPointAnnotation]()
            for _ in 0...5000 {
                let annotation = MKPointAnnotation()
                annotation.title = "Test"
                annotation.coordinate = CLLocationCoordinate2D(latitude: Double.random(in: 50...52), longitude: Double.random(in: 0...2))
                annotations.append(annotation)
            }
            DispatchQueue.main.async {
                self.allAnnotations = annotations
                self.updateVisibleAnnotations(mapView: self.mapView)
            }
        }
        
        // 监听地图区域变化
        mapView.addObserver(context.coordinator, forKeyPath: "region", options: [.new], context: nil)
        
        return mapView
    }
    
    private func updateVisibleAnnotations(mapView: MKMapView) {
        let visibleRect = mapView.visibleMapRect
        // 过滤可见区域内的标注
        let visibleAnnotations = allAnnotations.filter {
            visibleRect.contains(MKMapPoint($0.coordinate))
        }
        
        let currentAnnotations = mapView.annotations.filter { !($0 is MKUserLocation) }
        // 添加新可见标注，移除不可见标注
        let toAdd = visibleAnnotations.filter { !currentAnnotations.contains($0) }
        let toRemove = currentAnnotations.filter { !visibleAnnotations.contains($0) }
        
        mapView.removeAnnotations(toRemove)
        mapView.addAnnotations(toAdd)
    }
    
    func updateUIView(_ uiView: MKMapView, context: Context) {}
}

更新MapViewCoordinator： #

class MapViewCoordinator: NSObject, MKMapViewDelegate {
    var mapViewController: MapView
    
    init(_ control: MapView) {
        self.mapViewController = control
    }
    
    override func observeValue(forKeyPath keyPath: String?, of object: Any?, change: [NSKeyValueChangeKey : Any]?, context: UnsafeMutableRawPointer?) {
        if keyPath == "region" {
            mapViewController.updateVisibleAnnotations(mapView: mapViewController.mapView)
        }
    }
    
    deinit {
        mapViewController.mapView.removeObserver(self, forKeyPath: "region")
    }
    
    // ... 原viewFor方法
}

内容的提问来源于stack exchange，提问作者Kristoffer Jälén