SwiftUI中push跳转视图时.searchable不显示，模态视图正常？

在SwiftUI开发中，使用NavigationLink跳转（push）到SearchView时，.searchable()搜索栏无法显示；但以模态（sheet）方式呈现该视图时，搜索栏能正常显示。这是Apple的设计意图，还是实现方式有误？

演示效果：

相关代码 #

Home View

struct ContentView: View {
    @State private var showSearchView = false
    
    var body: some View {
        NavigationStack {
            VStack {
                NavigationLink(
                    destination: SearchView()
                ) {
                    Text("Push Search View")
                }
                .buttonStyle(.borderedProminent)
                .clipShape(Capsule())
                
                Button {
                    showSearchView = true
                } label: {
                    Text("Modal Search View")
                }
                .buttonStyle(.borderedProminent)
                .clipShape(Capsule())
            }
            .navigationTitle("Home")
        }
        .sheet(isPresented: $showSearchView) {
            SearchView()
        }
    }
}

Search View

struct SearchView: View {
    @State private var searchText = ""
    
    var body: some View {
        NavigationStack {
            Text("Searching for \(searchText)")
                .navigationTitle("Searchable Example")
        }
        .searchable(text: $searchText, prompt: "Look for something")
    }
}

问题原因与修复方案 #

这是实现方式的问题，并非Apple的设计意图。

问题核心在于SearchView中嵌套了额外的NavigationStack：通过NavigationLink跳转的视图本身已经处于父视图的NavigationStack层级中，此时在子视图里再嵌套一个NavigationStack，会导致.searchable()修饰符无法正确关联到当前活跃的导航栏。而模态视图是独立的导航上下文，嵌套的NavigationStack能正常工作，所以搜索栏显示正常。

方案一：移除多余的NavigationStack（推荐）

直接去掉SearchView中的NavigationStack，将内容和导航相关修饰符放在同一层级：

struct SearchView: View {
    @State private var searchText = ""
    
    var body: some View {
        Text("Searching for \(searchText)")
            .navigationTitle("Searchable Example")
            .searchable(text: $searchText, prompt: "Look for something")
    }
}

方案二：保留嵌套NavigationStack时调整修饰符位置

如果确实需要在SearchView中使用独立的导航栈，只需将.searchable()附加到内部的NavigationStack对应的内容层级中，确保它关联到正确的导航上下文：

struct SearchView: View {
    @State private var searchText = ""
    
    var body: some View {
        NavigationStack {
            Text("Searching for \(searchText)")
                .navigationTitle("Searchable Example")
                .searchable(text: $searchText, prompt: "Look for something")
        }
    }
}

第一种方案更符合SwiftUI的导航设计规范，代码更简洁，也能避免不必要的导航层级嵌套问题。

内容的提问来源于stack exchange，提问作者William T.