SwiftUI 如何在不弹出页面的前提下清除导航栈历史记录

和UIKit的setViewControllers(_:animated:)效果完全一致的实现方式分两种，对应不同的系统版本：

iOS 16+（推荐使用 NavigationStack） #

iOS16推出的NavigationStack原生支持通过绑定的路径对象直接控制整个导航栈结构，实现逻辑和UIKit完全对齐：

1. 先定义你的页面路由枚举，用于标识所有可跳转的页面

enum NavRoute: Hashable {
    case home
    case targetPage // 你要跳转的目标页
    case otherPage(name: String)
}

2. 在入口视图声明导航栈的绑定路径

struct RootView: View {
    // 整个导航栈的路径，和UIKit的viewControllers数组一一对应
    @State private var navPath = NavigationPath()
    
    var body: some View {
        NavigationStack(path: $navPath) {
            HomeView()
                .navigationDestination(for: NavRoute.self) { route in
                    switch route {
                    case .home: HomeView()
                    case .targetPage: TargetPage()
                    case .otherPage(let name): OtherPage(name: name)
                    }
                }
        }
        // 将导航路径注入环境，方便子视图调用修改
        .environment(\.navPath, $navPath)
    }
}

// 自定义环境变量传递导航路径
private struct NavPathKey: EnvironmentKey {
    static let defaultValue: Binding<NavigationPath> = .constant(NavigationPath())
}
extension EnvironmentValues {
    var navPath: Binding<NavigationPath> {
        get { self[NavPathKey.self] }
        set { self[NavPathKey.self] = newValue }
    }
}

3. 在需要触发替换跳转的位置，直接重写路径数组即可

// 任意子视图内的调用逻辑
@Environment(\.navPath) private var navPath

func jumpToTargetAndClearHistory() {
    // 直接将整个导航栈替换为仅包含目标页，等价于UIKit的setViewControllers
    withAnimation {
        navPath.wrappedValue = NavigationPath([NavRoute.targetPage])
    }
}

兼容 iOS 15及更低版本（使用 NavigationView） #

旧版本SwiftUI的NavigationView没有原生的栈控制API，我们可以直接访问底层的UINavigationController调用原生方法：

extension UIApplication {
    var currentNavController: UINavigationController? {
        (connectedScenes.first as? UIWindowScene)?.windows.first?.rootViewController as? UINavigationController ??
        (connectedScenes.first as? UIWindowScene)?.windows.first?.rootViewController?.navigationController
    }
}

// 调用时机，比如在新视图的onAppear回调里
struct TargetPage: View {
    var body: some View {
        Text("目标页")
            .onAppear {
                guard let nav = UIApplication.shared.currentNavController else { return }
                nav.setViewControllers([UIHostingController(rootView: self)], animated: true)
            }
    }
}

注意：该方案仅适用于SwiftUI外层包裹原生UINavigationController的场景，如果是纯SwiftUI的NavigationView，建议通过主动控制所有页面的isActive绑定值来重置导航栈。

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