SwiftUI：navigationDestination(item:)在macOS上无法工作的问题排查

问题分析 #

你遇到的问题是：navigationDestination(item:destination:)在iOS上正常工作，但在macOS中点击按钮无反应，而navigationDestination(isPresented:destination:)双平台都能正常运行。核心原因是macOS对导航目标修饰符的作用位置和路径推断有更严格的要求。

修复步骤 #

方法1：调整修饰符作用位置

将navigationDestination(item:destination:)从Button上移到NavigationStack的直接子容器视图（比如VStack）上，macOS需要导航目标修饰符处于更顶层的视图层级中：

struct ContentView1: View {
    @State var text: String?

    var body: some View {
        NavigationStack {
            VStack { // 添加容器视图
                Button("Subview") {
                    text = "Subview"
                }
            }
            .navigationDestination(item: $text) { text in
                Text(text)
            }
        }
    }
}

方法2：显式声明NavigationStack路径类型

如果需要更精确的路径控制，可以显式指定NavigationStack的路径绑定类型（适用于多导航场景）：

struct ContentView1: View {
    @State var path: [String] = []

    var body: some View {
        NavigationStack(path: $path) {
            Button("Subview") {
                path.append("Subview")
            }
            .navigationDestination(for: String.self) { text in
                Text(text)
            }
        }
    }
}

额外注意事项 #

• 确保项目的macOS部署目标设置为**13.0（Ventura）**或更高版本，navigationDestination API仅在该版本及以上可用。
• 当使用可选类型作为item绑定时，macOS需要明确的类型推断，将修饰符放在顶层容器可以帮助系统正确识别导航目标。

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