用途：这是一个基于症状的 MapKit 排错技能，先描述你看到的现象，再沿诊断路径逐项排查，适用于 iOS/SwiftUI 与 MKMapView 开发中的地图显示与交互问题。
主要能力与检查点：
- 标注不显示：校验坐标是否有效、是否为 0/0 或 NaN、纬经度是否颠倒（GeoJSON 为 [lng, lat]，MapKit 用 (latitude, longitude)）；检查 viewFor 委托与 displayPriority。
- 区域跳动/循环：UIViewRepresentable 中 updateUIView 无保护地调用 setRegion 会造成循环，应加区域相等判断或 coordinator 标志位；避免多个状态源争夺相机位置。
- 性能：大于 500 个标注启用聚类（view.clusteringIdentifier 或 .mapItemClusteringIdentifier），必要时做可视区域过滤、视图重用、几何简化，避免循环调用地理编码。
- 聚类失效：所有相关标注视图需设置同一 clusteringIdentifier；聚类仅在标注实际重叠时生效，缩放级别不同表现不同。
- 覆盖物不渲染：必须实现 rendererFor 委托并返回匹配的渲染器子类（MKCircleRenderer、MKPolylineRenderer、MKPolygonRenderer 等），设置描边与线宽，注意 overlay level。
- 搜索/路线失败：需网络可用；resultTypes 与 region 偏置要合理，查询用自然语言，避免逐键触发搜索，注意限流。
- 用户位置不显示：先确认定位授权状态并请求授权，MKMapView 设 showsUserLocation，SwiftUI 加 UserAnnotation()，模拟器需手动设置位置。
- 坐标系混淆：区分 CLLocationCoordinate2D 与 MKMapPoint，后者是投影坐标，不能当经纬度使用；可用校验函数判断范围与 NaN。
限制：资料未提供具体价格、平台版本要求与完整可运行示例；部分修复需结合实际工程验证。日志可参考 log stream 过滤 com.apple.MapKit 与 com.apple.CoreLocation。