SwiftUI中NavigationStack为何不显示工具栏与搜索栏？

NavigationStack 中使用 .searchable 完全可以让搜索栏显示在工具栏，问题多半出在代码结构上，以下是正确的用法和注意事项：

正确代码示例 #

struct ContentView: View {
    @State private var searchText = ""
    
    var body: some View {
        NavigationStack {
            List {
                ForEach(0..<10) { index in
                    Text("Item \(index)")
                }
            }
            .navigationTitle("Demo")
            .searchable(text: $searchText) // 将修饰符应用到NavigationStack内部的根容器视图
        }
    }
}

关键注意事项 #

• 不要直接修饰NavigationStack：.searchable 需要附加在 NavigationStack 内部的根视图（比如 List、ScrollView 这类容器）上，而非 NavigationStack 本身。
• 必须设置navigationTitle：搜索栏依附在导航栏区域，没有设置明确的导航标题时，搜索栏可能不会显示。
• 嵌套视图的处理：如果是在 NavigationStack 的路径跳转后的子视图中添加搜索栏，同样要将 .searchable 加到子视图的容器上，并给子视图设置 navigationTitle。

示例（子视图搜索栏）：

struct DetailView: View {
    @State private var detailSearchText = ""
    
    var body: some View {
        List {
            ForEach(0..<5) { index in
                Text("Detail Item \(index)")
            }
        }
        .navigationTitle("Detail")
        .searchable(text: $detailSearchText)
    }
}

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