SwiftUI如何切换至页面时自动唤起键盘并聚焦文本框？

问题分析 #

你在开发搜索页面时，希望进入页面就让文本框自动获取焦点并唤起键盘，尝试用.focused(focused)修饰符配合.onAppear/.onChanged时出现键盘闪烁，自定义UIViewRepresentable文本框也未解决问题。核心原因通常是：

• 原生focused的状态更新时机与视图渲染不同步，导致重复触发焦点切换
• 自定义文本框的updateUIView方法中每次强制调用becomeFirstResponder，引发不必要的重复唤起

解决方案一：优化原生SwiftUI TextField实现 #

用@FocusState替代手动维护focus变量，配合DispatchQueue.main.async延迟触发，避免视图渲染时的冲突：

struct SearchView: View {
    @State private var searchText = ""
    @FocusState private var isSearchFocused: Bool
    
    var body: some View {
        TextField("搜索...", text: $searchText)
            .focused($isSearchFocused)
            .onAppear {
                // 延迟触发，等视图完全渲染后再设置焦点
                DispatchQueue.main.async {
                    isSearchFocused = true
                }
            }
            // 可选：防止用户手动收起键盘后自动弹出（如果需要强制保持）
            .onChange(of: isSearchFocused) { newValue in
                if !newValue {
                    DispatchQueue.main.async {
                        isSearchFocused = true
                    }
                }
            }
    }
}

解决方案二：修复自定义UIViewRepresentable文本框 #

去掉updateUIView中不必要的强制唤起逻辑，仅在视图初始化时设置一次焦点，同时优化文本同步逻辑：

struct TextFieldPermanentKeyboard: UIViewRepresentable {
    var placeholder: String
    @Binding var text: String
    var onCommit: () -> Void
    
    final class Coordinator: NSObject, UITextFieldDelegate {
        var parent: TextFieldPermanentKeyboard
        
        init(_ parent: TextFieldPermanentKeyboard) {
            self.parent = parent
        }
        
        func textFieldDidChangeSelection(_ textField: UITextField) {
            parent.text = textField.text ?? ""
        }
        
        @objc func onCommit() {
            parent.onCommit()
        }
        
        // 可选：强制保持焦点，禁止文本框失去编辑状态
        func textFieldShouldEndEditing(_ textField: UITextField) -> Bool {
            return false
        }
    }
    
    func makeCoordinator() -> Coordinator {
        Coordinator(self)
    }
    
    func makeUIView(context: Context) -> UITextField {
        let textfield = UITextField()
        textfield.delegate = context.coordinator
        textfield.placeholder = placeholder
        textfield.text = text
        // 仅在初始化时设置焦点
        textfield.becomeFirstResponder()
        
        textfield.addTarget(
            context.coordinator,
            action: #selector(context.coordinator.onCommit),
            for: .editingDidEndOnExit
        )
        
        // 监听文本变化同步到Binding
        textfield.addTarget(
            context.coordinator,
            action: #selector(Coordinator.textFieldDidChangeSelection(_:)),
            for: .editingChanged
        )

        return textfield
    }
    
    func updateUIView(_ uiView: UITextField, context: Context) {
        // 仅当文本不一致时更新，避免不必要的视图刷新
        if uiView.text != text {
            uiView.text = text
        }
    }
}

额外注意事项 #

• 若需强制保持键盘不被收起，可在Coordinator中实现textFieldShouldEndEditing并返回false，阻止编辑结束
• 避免在视图更新周期内频繁调用becomeFirstResponder，这是导致键盘闪烁的核心诱因之一

内容的提问来源于stack exchange，提问作者VOIDЕМОRT 13