SwiftUI使用MapKit时.followWithHeading模式如何禁止地图自动缩放？

问题原因 #

• 每次定位更新触发updateUIView时，你都强制重新赋值userTrackingMode = .followWithHeading，MKMapView的该模式每次被重置时都会自动恢复默认缩放等级，是导致缩放回弹的核心原因
• 额外手动设置centerCoordinate的操作和追踪模式功能重叠，会进一步干扰用户手动调整后的地图状态

修复实现 #

核心逻辑调整 #

• 追踪模式仅在初始化时设置一次，日常更新不重复赋值
• 监听地图用户交互事件，手动调整后仅同步中心坐标和朝向，不修改缩放级别
• 保留centreUserLocation参数作为主动恢复自动追踪的开关

修改后完整代码 #

struct FlightView: View {
    @EnvironmentObject var locationManager : GCLocationManager
    @State var centreUserLocation : Bool = false
    // 原代码缺失的flight、initalZoomDone变量需按你的业务补充定义
    let flight: Flight
    @State var initalZoomDone: Bool = false

    var body: some View {
            GCMapView(
                flight: flight,
                userLocation: locationManager.userLocation,
                centreUserLocation: $centreUserLocation,
                initalZoomDone: $initalZoomDone
            )
    }
}

struct GCMapView : UIViewRepresentable {
    let flight: Flight
    var userLocation: CLLocation?
    @Binding var centreUserLocation: Bool
    @Binding var initalZoomDone: Bool
    
    func makeUIView(context: Context) -> MKMapView {
        // 不要把MKMapView定义为全局属性，避免视图复用出现状态混乱
        let map = MKMapView()
        map.delegate = context.coordinator
        map.isRotateEnabled = true
        map.userTrackingMode = .followWithHeading
        map.showsUserLocation = true
        return map
    }
    func updateUIView(_ view: MKMapView, context: Context) {
        // 仅主动触发居中时才重置追踪模式，恢复默认缩放+自动追踪
        if centreUserLocation {
            view.userTrackingMode = .followWithHeading
            DispatchQueue.main.async {
                centreUserLocation = false
            }
            return
        }
        
        // 用户手动调整过地图的场景：仅更新中心坐标，保留当前缩放级别
        if let userLocation = userLocation, context.coordinator.isUserManuallyModified {
            var currentRegion = view.region
            currentRegion.center = userLocation.coordinate
            view.setRegion(currentRegion, animated: true)
        }
    }
    
    func makeCoordinator() -> Coordinator {
        return Coordinator(self)
    }
    class Coordinator: NSObject, MKMapViewDelegate {
        var parent: GCMapView
        // 标记用户是否通过手势修改过地图状态
        var isUserManuallyModified = false
        
        init(_ parent: GCMapView) {
            self.parent = parent
            super.init()
        }
        
        // 监听地图区域变化，识别用户主动交互操作
        func mapView(_ mapView: MKMapView, regionWillChangeAnimated animated: Bool) {
            let isUserInteraction = mapView.isZooming || mapView.isScrolling || mapView.isRotating
            if isUserInteraction {
                isUserManuallyModified = true
                // 关闭系统自动追踪，避免缩放被重置
                mapView.userTrackingMode = .none
            }
        }
        
        // 可选：初始定位完成后自定义默认缩放级别
        func mapView(_ mapView: MKMapView, didUpdate userLocation: MKUserLocation) {
            guard !parent.initalZoomDone else { return }
            let region = MKCoordinateRegion(center: userLocation.coordinate, latitudinalMeters: 1000, longitudinalMeters: 1000)
            mapView.setRegion(region, animated: true)
            parent.initalZoomDone = true
        }
    }
}

补充说明 #

• 手动修改缩放后，地图自动对齐正北的特性会由系统默认保留，无需额外适配
• 如果不需要主动回到用户中心的功能，可以直接删除centreUserLocation相关逻辑
• 你原代码中全局定义MKMapView实例的写法会导致SwiftUI视图复用时出现状态异常，改为在makeUIView内部创建即可避免这类问题

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