SwiftUI中List内搜索TextField无结果时丢失焦点问题排查

当搜索结果为空时，ForEach不再生成任何子视图，导致List的子视图结构从「TextField + N个Text行」变为「仅TextField行」。SwiftUI的视图系统在面对这种视图结构突变时，会重新初始化TextField实例，进而导致键盘焦点丢失。同理，从无结果变回有结果时，视图结构再次突变，同样会触发TextField的重置。

核心思路是保持视图结构的稳定性，不让List的子视图集合因过滤结果为空而发生根本性变化。以下是两种可行方案：

方案1：使用Section固定结构 #

将TextField和过滤结果分别放在独立的Section中，无论过滤结果是否为空，Section都会存在于视图树中，避免结构突变：

struct TestView: View {
    let items = ["abc", "aaa", "bbb", "ccc"]
    @State var text = ""

    // 把过滤逻辑抽为计算属性，提升代码可读性
    private var filteredItems: [String] {
        items.filter { text.isEmpty || $0.localizedStandardContains(text) }
    }

    var body: some View {
        List {
            // 搜索框所在Section，始终存在
            Section {
                TextField("enter text", text: $text)
            }
            // 结果列表所在Section，始终存在
            Section {
                ForEach(filteredItems, id: \.self) { item in
                    Text(item)
                }
            }
        }
    }
}

方案2：添加空状态占位行 #

在过滤结果为空时，显示一个空状态提示行，确保List的子视图数量不会出现「从多到一」的突变：

struct TestView: View {
    let items = ["abc", "aaa", "bbb", "ccc"]
    @State var text = ""

    var body: some View {
        List {
            TextField("enter text", text: $text)
            let filtered = items.filter { text.isEmpty || $0.localizedStandardContains(text) }
            ForEach(filtered, id: \.self) { item in
                Text(item)
            }
            // 空状态占位，保持视图结构稳定
            if filtered.isEmpty {
                Text("无搜索结果")
                    .foregroundColor(.secondary)
            }
        }
    }
}

你提到的「逐项过滤而非整体过滤」本质上也是通过保持ForEach的数据源始终非空（比如给每个项添加是否显示的标记）来维持视图结构稳定，和上述方案的核心逻辑一致。

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