SwiftUI中设置TextField自动聚焦不生效是什么原因

问题原因 #

这个问题的核心是onAppear的触发时机早于视图布局完成的时机：

• onAppear会在视图刚被加入渲染树、即将显示到屏幕上时触发，此时Form内部的TextField还没有完成布局加载，@FocusState和控件的绑定关系还未完全生效，这时候修改nameIsFocused的值系统无法响应，自然不会触发聚焦。
• 如果你是在iOS15系统上运行，该版本刚推出FocusStateAPI，对Form、List容器内的输入控件聚焦支持存在已知bug，也会导致该问题。

修复方案 #

最简单通用的修复方式是给聚焦状态的赋值增加微小延迟，等视图布局完成后再修改状态：

struct MyView: View {
    @State var name: String = ""
    @FocusState private var nameIsFocused: Bool
    
    var body: some View {
        Form {  
            TextField("Name", text: $name)
                .focused($nameIsFocused)
        }
        .onAppear {
            // 增加0.1秒延迟，等待视图布局完成
            DispatchQueue.main.asyncAfter(deadline: .now() + 0.1) {
                nameIsFocused = true
            }
        }
    }
}

如果是iOS16及以上版本，也可以配合task修饰符实现，不需要手动控制延迟：

.task {
    nameIsFocused = true
}

额外注意点 #

• 测试时优先使用真机，模拟器如果没有开启软键盘（可以通过I/O -> Keyboard -> Toggle Software Keyboard开启），即使聚焦成功也看不到输入光标，容易误判。
• 确认TextField没有添加disabled、allowsHitTesting(false)等限制交互的修饰符，这些修饰符会阻止控件获得焦点。

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