SwiftUI新NavigationStack API与UIHostingController导航栏适配问题

问题核心 #

在UIKit应用中通过UIHostingController嵌入SwiftUI视图时，旧版无NavigationView包裹的NavigationLink可以正常复用UIKit的导航栏，但切换到新版NavigationStack API后，SwiftUI会创建独立导航容器，导致无法复用原有UIKit导航栏，出现导航栏冲突或行为异常。

解决方案 #

移除SwiftUI视图中的NavigationStack容器，直接将navigationDestination修饰符应用在根视图（如List）上，配合NavigationLink(value:)使用，让SwiftUI自动适配UIKit的导航栈。

修改后的代码 #

import UIKit
import SwiftUI

struct ListView: View {
  
  @State var selectedString: String? = nil
  
  var body: some View {
    let details = ["foo", "bar", "baz"]

    List {
      ForEach(details, id: \.self) { detail in
        let destination = Text("This is a detailed page for \(detail)")
          .navigationTitle("Detail page")
        
        NavigationLink(
          detail,
          destination: destination,
          tag: detail,
          selection: $selectedString)
      }
    }
    .navigationTitle("List page")
  }
}

// 修改后的新版API实现
struct ListViewWithNewAPI: View {
  @State var selectedString: String? = nil
  
  var body: some View {
    let details = ["foo", "bar", "baz"]
    
    // 移除NavigationStack容器，直接使用List+navigationDestination
    List(details, id: \.self) { detail in
      NavigationLink(detail, value: detail)
    }
    // 直接在根视图上添加navigationDestination修饰符
    .navigationDestination(for: String.self) { detail in
      Text("This is a detailed page for \(detail)")
        .navigationTitle("Detail page")
    }
    .navigationTitle("List page")
    .navigationBarTitleDisplayMode(.inline)
  }
}

class ViewController: UIViewController {

  @objc
  private func tapButton1() {
    let listVC = UIHostingController(rootView: ListView())
    navigationController?.pushViewController(listVC, animated: true)
  }
  
  @objc
  private func tapButton2() {
    let listVC = UIHostingController(rootView: ListViewWithNewAPI())
    navigationController?.pushViewController(listVC, animated: true)
  }
  
  override func viewDidLoad() {
    super.viewDidLoad()
    
    let button1 = UIButton(frame: CGRect(x: 100, y: 100, width: 100, height: 100))
    button1.backgroundColor = .green
    button1.addTarget(self, action: #selector(tapButton1), for: .touchUpInside)
    view.addSubview(button1)
    
    let button2 = UIButton(frame: CGRect(x: 100, y: 300, width: 100, height: 100))
    button2.backgroundColor = .red
    button2.addTarget(self, action: #selector(tapButton2), for: .touchUpInside)
    view.addSubview(button2)
   
    navigationItem.title = "UIKit title"
  }
}

原理说明 #

• 旧版方案中，SwiftUI视图未包裹NavigationView，直接复用UIKit的UINavigationController栈，NavigationLink的跳转由UIKit处理。
• 新版NavigationStack默认会创建自身的导航容器，与UIKit的导航栈独立，导致无法复用原有导航栏。移除NavigationStack后，navigationDestination会自动关联到UIKit的导航栈，既实现导航栏复用，又保留新版API的类型安全导航特性。
• 如需自定义导航栏元素（如按钮），可通过SwiftUI的toolbar修饰符添加，这些元素会自动映射到UIKit的导航栏上。

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