MapView未显示标注：首次使用MapKit开发二手店定位App遇阻

1. 代理方法签名错误（核心问题） #

你的mapView(viewForAnnotation:)方法使用了旧版Swift语法，导致MapKit无法识别该代理方法，即便成功添加标注，也无法生成对应的标注视图。

错误代码：

func mapView(mapView: MKMapView, viewForAnnotation annotation: MKAnnotation) -> MKAnnotationView? {
    // ...
}

修复后代码：

func mapView(_ mapView: MKMapView, viewFor annotation: MKAnnotation) -> MKAnnotationView? {
    if annotation is MKUserLocation {
        return nil
    } else {
        let pinIdent = "Pin"
        var pinView: MKPinAnnotationView
        
        if let dequeuedView = mapView.dequeueReusableAnnotationView(withIdentifier: pinIdent) as? MKPinAnnotationView {
            dequeuedView.annotation = annotation
            pinView = dequeuedView
        } else {
            pinView = MKPinAnnotationView(annotation: annotation, reuseIdentifier: pinIdent)
            // 可自定义pin颜色，方便识别
            pinView.pinTintColor = .red
        }
        return pinView
    }
}

2. 缺少位置权限描述（可能导致搜索无结果） #

你调用了locationManager.requestWhenInUseAuthorization()，但未在Info.plist中添加权限描述键，系统不会弹出授权弹窗，位置管理器无法获取当前位置，导致搜索请求的区域无效，自然搜不到二手店结果。

解决方法：
在Info.plist中新增键值对：

• 键：Privacy - Location When In Use Usage Description
• 值：需要获取你的位置来查找周边二手店（可自定义描述内容）

3. MKPlacemark无标题导致标注不易察觉 #

直接使用MKPlacemark作为标注时，默认title和subtitle为空，即便标注已添加到地图，也只是无文字的pin，容易被忽略。

优化方案：
将MKPlacemark包装为MKPointAnnotation并设置标题信息：

for item in response.mapItems {
    let annotation = MKPointAnnotation()
    annotation.coordinate = item.placemark.coordinate
    annotation.title = item.name
    annotation.subtitle = item.placemark.title
    self.theMap.addAnnotation(annotation)
}

4. 搜索区域设置时机问题 #

你在调用theMap.setRegion(animated: true)后立即发起搜索，由于区域更新是异步动画，此时地图区域可能未完成更新，导致搜索范围不准确。

修复代码：

// 直接用当前位置坐标创建搜索区域，不依赖地图的异步更新
searchRequest.region = MKCoordinateRegion(center: coordinates, latitudinalMeters: 5000, longitudinalMeters: 5000)

额外调试建议 #

在搜索的回调中添加错误打印，方便排查搜索失败原因：

search.start { (response, error) in
    if let error = error {
        print("搜索失败：\(error.localizedDescription)")
        return
    }
    guard let response = response else {
        print("无搜索结果")
        return
    }
    // 添加标注的代码
}

另外可以移除冗余的coordinates: [String]数组，你并未使用到它。

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