Swift 4：如何等待MKMapView加载完成后再添加标注

你碰到的这个坑我之前也踩过！MKMapView的初始化和渲染是异步进行的，哪怕你在viewDidLoad里拿到了IBOutlet的引用，它可能还没完全准备好，这时候直接加标注就会因为对象nil崩溃。给你两个靠谱的解决方案：

方法一：利用MKMapViewDelegate的加载完成回调（官方推荐） #

这个方法会严格等待地图的所有资源（比如瓦片、渲染层）都加载完成后再执行标注添加，是最稳妥的方式：

1. 让你的ViewController遵守MKMapViewDelegate协议
2. 在viewDidLoad里给mapView设置代理
3. 实现mapViewDidFinishLoadingMap方法，把添加标注的逻辑放在这里

修改后的代码示例：

import UIKit
import MapKit

class ViewController: UIViewController, MKMapViewDelegate {
    @IBOutlet weak var mapView: MKMapView!

    override func viewDidLoad() {
        super.viewDidLoad()
        // 设置代理，监听地图加载状态
        mapView.delegate = self
        
        // 这里可以先做地图的基础配置，比如设置显示区域
        let coordinate = CLLocationCoordinate2D(latitude: 39.9042, longitude: 116.4074)
        let region = MKCoordinateRegion(center: coordinate, latitudinalMeters: 10000, longitudinalMeters: 10000)
        mapView.setRegion(region, animated: true)
    }

    // 地图完全加载完成后触发的回调
    func mapViewDidFinishLoadingMap(_ mapView: MKMapView) {
        // 在这里安全地添加标注
        let annotation = MKPointAnnotation()
        annotation.coordinate = CLLocationCoordinate2D(latitude: 39.9042, longitude: 116.4074)
        annotation.title = "北京"
        annotation.subtitle = "中国首都"
        mapView.addAnnotation(annotation)
    }
}

方法二：在viewDidAppear里添加标注 #

如果你的标注不需要严格等地图渲染完成，只是要确保mapView肯定非nil，那么可以把添加逻辑放在viewDidAppear里——因为这个方法触发时，视图已经完全显示在屏幕上，mapView的初始化肯定完成了：

override func viewDidAppear(_ animated: Bool) {
    super.viewDidAppear(animated)
    
    // 在这里添加标注
    let annotation = MKPointAnnotation()
    annotation.coordinate = CLLocationCoordinate2D(latitude: 39.9042, longitude: 116.4074)
    annotation.title = "北京"
    mapView.addAnnotation(annotation)
}

两种方法的区别 #

• 方法一：适合需要和地图交互的场景（比如标注依赖地图的当前区域），能保证标注和地图同步出现
• 方法二：执行时机更早，但如果地图加载较慢，可能会出现标注先显示、地图后渲染的视觉差异

最后小提醒：检查一下你的IBOutlet是不是已经正确绑定了——可以在viewDidLoad里加个断言做校验，避免因为绑定错误导致的nil问题：

assert(mapView != nil, "mapView未在Storyboard/XIB中正确绑定！")

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