SwiftUI嵌入UIHostingViewController时导航标题延迟显示的解决问询

问题概述 #

将嵌入SwiftUI View的UIHostingViewController推入导航栈时，导航大标题会出现明显的显示延迟；但直接使用原生UIViewController时，标题能立即显示。对应的SwiftUI代码如下：

struct SwiftUIView: View {
  var body: some View {
    EmptyView()
          .navigationTitle("SwiftUI View")
  }
}

问题根源在于大标题的异步外观更新流程：UIHostingController需要从SwiftUI视图环境中读取导航标题，这个传递环节存在异步延迟，导致标题显示滞后。

目前已找到一种临时解决方案：在推入UIHostingViewController前，直接设置其.title属性，但希望从SwiftUI组件层面彻底解决该问题。

SwiftUI层面的可行解决方案 #

方案1：通过UIViewControllerRepresentable同步注入标题 #

创建一个桥接视图，直接在SwiftUI内部向导航栈同步设置标题，绕过SwiftUI环境的异步传递：

struct SyncNavigationTitleView: UIViewControllerRepresentable {
    let title: String
    
    func makeUIViewController(context: Context) -> UIViewController {
        let vc = UIViewController()
        vc.title = title
        return vc
    }
    
    func updateUIViewController(_ uiViewController: UIViewController, context: Context) {
        uiViewController.title = title
    }
}

// 使用示例
struct SwiftUIView: View {
    var body: some View {
        ZStack {
            EmptyView()
            SyncNavigationTitleView(title: "SwiftUI View")
        }
        .navigationBarTitleDisplayMode(.large)
    }
}

原理：借助UIViewControllerRepresentable直接对接原生导航栈的标题设置逻辑，和原生UIViewController的标题更新流程完全一致，避免了SwiftUI环境传递的异步延迟。

方案2：自定义立即更新标题的修饰符 #

创建自定义View修饰符，在视图出现时直接操作原生导航控制器设置标题，同时保留SwiftUI的navigationTitle以维持状态同步：

struct ImmediateNavigationTitle: ViewModifier {
    let title: String
    
    func body(content: Content) -> some View {
        content
            .onAppear {
                guard let rootVC = UIApplication.shared.connectedScenes
                        .compactMap({ $0 as? UIWindowScene })
                        .first?.windows.first?.rootViewController,
                      let navController = rootVC as? UINavigationController,
                      let topVC = navController.topViewController else { return }
                topVC.title = title
            }
            .navigationTitle(title)
    }
}

// 扩展View方便调用
extension View {
    func immediateNavigationTitle(_ title: String) -> some View {
        self.modifier(ImmediateNavigationTitle(title: title))
    }
}

// 使用示例
struct SwiftUIView: View {
    var body: some View {
        EmptyView()
            .immediateNavigationTitle("SwiftUI View")
            .navigationBarTitleDisplayMode(.large)
    }
}

原理：在SwiftUI视图出现的时机，直接操作原生导航控制器的标题属性，提前完成标题设置；同时保留navigationTitle修饰符，确保SwiftUI内部的导航环境状态和原生导航栏保持一致，避免后续状态异常。

问题深层原因 #

SwiftUI的navigationTitle是通过**环境（Environment）**将标题信息传递给UIHostingController的，这个传递过程是异步的；而原生UIViewController的title是直接同步写入导航栈的状态中。当启用大标题样式时，UIKit需要额外处理标题的动画过渡和布局计算，异步传递的延迟就会被视觉化地放大，最终表现为标题显示滞后。

内容的提问来源于stack exchange，提问作者Vlad Z.