如何在iOS15/16兼容项目中混用NavigationView与NavigationStack？

直接在版本判断分支里返回NavigationStack和NavigationView会报错，核心原因是SwiftUI要求同一分支下返回的视图类型必须完全一致，而这两个是不同的视图类型，所以Xcode不接受。

最简洁的解决办法就是封装一个自定义导航容器，把版本判断逻辑藏在内部，对外提供统一的调用方式：

1. 实现自定义兼容导航容器 #

import SwiftUI

struct CompatibleNavigationContainer<Content: View>: View {
    @ViewBuilder let content: () -> Content
    
    var body: some View {
        if #available(iOS 16, *) {
            NavigationStack {
                content()
            }
        } else {
            NavigationView {
                content()
            }
            .navigationViewStyle(.stack) // 强制iPhone使用栈式布局，和NavigationStack行为对齐
        }
    }
}

// 可选：简化调用语法的扩展
extension CompatibleNavigationContainer {
    init(@ViewBuilder content: @escaping () -> Content) {
        self.content = content
    }
}

2. 直接替换原有导航组件使用 #

把原来的NavigationView/NavigationStack直接换成CompatibleNavigationContainer即可，内部会自动适配系统版本：

struct DemoView: View {
    var body: some View {
        CompatibleNavigationContainer {
            List(1...20, id: \.self) { index in
                NavigationLink("跳转至详情 \(index)", destination: DetailView(index: index))
            }
            .navigationTitle("兼容导航示例")
        }
    }
}

struct DetailView: View {
    let index: Int
    var body: some View {
        Text("详情页 \(index)")
            .navigationTitle("详情")
    }
}

进阶：支持iOS16的Path导航 #

如果需要在iOS16中使用NavigationStack的路径绑定功能，可以扩展自定义容器，添加对应参数：

extension CompatibleNavigationContainer {
    // 带path参数的初始化方法，仅iOS16生效
    init<Path: Hashable>(path: Binding<[Path]>, @ViewBuilder content: @escaping () -> Content) {
        self.content = content
        self._internalPath = .constant(path.wrappedValue as [AnyHashable])
        self.pathBinding = path
    }
    
    // 内部存储path相关属性
    @Binding private var internalPath: [AnyHashable]
    private let pathBinding: Any?
    
    var body: some View {
        if #available(iOS 16, *), let path = pathBinding as? Binding<[some Hashable]> {
            NavigationStack(path: path) {
                content()
            }
        } else {
            NavigationView {
                content()
            }
            .navigationViewStyle(.stack)
        }
    }
}

使用示例：

struct PathDemoView: View {
    @State private var navigationPath: [String] = []
    
    var body: some View {
        CompatibleNavigationContainer(path: $navigationPath) {
            Button("跳转到详情A") {
                navigationPath.append("A")
            }
            .navigationDestination(for: String.self) { item in
                Text("详情页 \(item)")
            }
            .navigationTitle("Path导航示例")
        }
    }
}

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