iPad外接物理键盘时SwiftUI TextField无法换行问题求助

问题原因 #

SwiftUI 16+引入的TextField(axis: .vertical)在使用外接物理键盘时，默认将回车键映射为提交操作（触发onSubmit并失去焦点），而非换行；而虚拟键盘的换行键则默认执行换行逻辑，导致行为不一致。

解决思路 #

方法1：SwiftUI原生修改（简单但需注意边界） #

通过onSubmit拦截提交事件，手动插入换行符并重新获取焦点，保持输入状态：

TextField("Message", text: $messageToSend, axis: .vertical)
    .focused($editing)
    .onSubmit {
        // 插入换行符
        messageToSend += "\n"
        // 强制重新获取焦点，避免失焦
        editing = true
    }

注意：该方法可能会导致虚拟键盘的换行键触发两次换行（虚拟键盘默认已插入换行，同时onSubmit又追加一次），需额外判断输入设备类型，或仅在外接键盘场景下生效。

方法2：自定义UITextView包装（更可靠） #

由于UITextView原生支持回车换行（无论外接还是虚拟键盘），可以通过UIViewRepresentable包装UITextView替代原生TextField，彻底统一行为：

struct MultiLineTextField: UIViewRepresentable {
    @Binding var text: String
    @Binding var isEditing: Bool
    let placeholder: String
    
    func makeUIView(context: Context) -> UITextView {
        let textView = UITextView()
        textView.font = .systemFont(ofSize: 16)
        textView.textPlaceholder = placeholder
        textView.delegate = context.coordinator
        textView.returnKeyType = .default // 回车直接换行
        textView.textContainer.lineFragmentPadding = 0
        textView.textContainerInset = .init(top: 8, left: 4, bottom: 8, right: 4)
        return textView
    }
    
    func updateUIView(_ uiView: UITextView, context: Context) {
        if uiView.text != text {
            uiView.text = text
        }
        // 同步焦点状态
        if isEditing != uiView.isFirstResponder {
            isEditing ? uiView.becomeFirstResponder() : uiView.resignFirstResponder()
        }
    }
    
    func makeCoordinator() -> Coordinator {
        Coordinator(self)
    }
    
    class Coordinator: NSObject, UITextViewDelegate {
        let parent: MultiLineTextField
        
        init(_ parent: MultiLineTextField) {
            self.parent = parent
        }
        
        func textViewDidChange(_ textView: UITextView) {
            parent.text = textView.text
        }
        
        func textViewDidBeginEditing(_ textView: UITextView) {
            parent.isEditing = true
        }
        
        func textViewDidEndEditing(_ textView: UITextView) {
            parent.isEditing = false
        }
    }
}

使用方式：

MultiLineTextField(text: $messageToSend, isEditing: $editing, placeholder: "Message")

该方法完全统一了虚拟键盘和外接键盘的回车行为，且支持TextField的核心功能（占位符、焦点绑定、文本双向绑定）。

方法3：修改提交按钮类型（仅部分场景生效） #

通过submitLabel(.newline)将键盘右下角的按钮改为“换行”，部分外接键盘会响应此设置，将回车键映射为换行：

TextField("Message", text: $messageToSend, axis: .vertical)
    .focused($editing)
    .submitLabel(.newline)

注意：该方法依赖外接键盘的兼容性，部分键盘可能仍然将回车键视为提交，可靠性较低。

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