iOS / SwiftUI 输入法（键盘）布局处理总结（AI版）

📘 iOS / SwiftUI 输入法（键盘）处理总结

一、问题背景

在 iOS / SwiftUI 开发中，常见输入法问题：

• 输入框切换时键盘闪烁
• 键盘弹出/收起动画不自然
• 无法像 Android WindowInsetsAnimation 一样平滑跟随

二、输入框切换闪烁问题

❌ 错误原因

focusedField=nilfocusedField=.password

解决办法

enumField{caseusernamecasepassword}@FocusStateprivatevarfocusedField:Field?TextField("用户名",text:$username).focused($focusedField,equals:.username)SecureField("密码",text:$password).focused($focusedField,equals:.password)

❗ 注意
不要先设为 nil
不要手动关闭键盘
使用系统焦点切换

键盘动画（类似 Android Insets）

uikit

@objcfunckeyboardWillChangeFrame(_notification:Notification){guardletuserInfo=notification.userInfoelse{return}letduration=userInfo[UIResponder.keyboardAnimationDurationUserInfoKey]as?Double??0.25letcurveRaw=userInfo[UIResponder.keyboardAnimationCurveUserInfoKey]as?UInt??0letcurve=UIView.AnimationOptions(rawValue:curveRaw<<16)letframe=userInfo[UIResponder.keyboardFrameEndUserInfoKey]as?CGRect??.zeroletkeyboardHeight=UIScreen.main.bounds.height-frame.origin.yUIView.animate(withDuration:duration,delay:0,options:curve){self.bottomConstraint.constant=keyboardHeightself.view.layoutIfNeeded()}}

swiftUI

1. 推荐

.safeAreaInset(edge:.bottom){Color.clear.frame(height:0)}

2. combine

classKeyboardObserver:ObservableObject{@Publishedvarheight:CGFloat=0privatevarcancellables=Set<AnyCancellable>()init(){NotificationCenter.default.publisher(for:UIResponder.keyboardWillChangeFrameNotification).map{notification->CGFloatinletframe=notification.userInfo?[UIResponder.keyboardFrameEndUserInfoKey]as?CGRect??.zeroreturnUIScreen.main.bounds.height-frame.origin.y}.assign(to:\.height,on:self).store(in:&cancellables)}}structContentView:View{@StateObjectvarkeyboard=KeyboardObserver()varbody:someView{VStack{Spacer()TextField("输入",text:.constant("")).textFieldStyle(.roundedBorder)}.padding(.bottom,keyboard.height).animation(.easeOut(duration:0.25),value:keyboard.height)}}