修复ScrollView中键盘弹出时TextField上移过度问题的方法

你的问题核心在于固定了固定移动距离，完全没考虑TextField的实际位置和键盘高度，再加上直接移动整个view的方式在ScrollView场景下并不适配，才导致顶部TextField上移过度。咱们一步步来修正：

问题根源拆解 #

1. 硬写的moveDistance: -20太死板，不管TextField在屏幕哪个位置都移动相同距离，顶部的TextField自然会移得过多。
2. 直接修改self.view.frame不是ScrollView场景的正确姿势，应该调整ScrollView的contentOffset或contentInset，才能精准控制滚动位置。
3. 仅依赖textFieldDidBeginEditing/textFieldDidEndEditing触发移动，没有结合键盘的实际高度，很容易出现偏差。

修正后的完整方案 #

我们改用监听键盘通知的方式，结合TextField的位置动态计算滚动距离，同时操作ScrollView的属性来适配键盘：

第一步：注册键盘通知

在viewDidLoad里添加键盘弹出/收起的监听：

override func viewDidLoad() {
    super.viewDidLoad()
    
    // 注册键盘弹出/收起通知
    NotificationCenter.default.addObserver(self, selector: #selector(keyboardWillShow(_:)), name: UIResponder.keyboardWillShowNotification, object: nil)
    NotificationCenter.default.addObserver(self, selector: #selector(keyboardWillHide(_:)), name: UIResponder.keyboardWillHideNotification, object: nil)
}

// 记得在页面销毁时移除通知
deinit {
    NotificationCenter.default.removeObserver(self)
}

第二步：实现键盘通知的处理逻辑

@objc func keyboardWillShow(_ notification: Notification) {
    guard let userInfo = notification.userInfo,
          let keyboardFrame = userInfo[UIResponder.keyboardFrameEndUserInfoKey] as? CGRect,
          let activeTextField = UIResponder.currentFirstResponder() as? UITextField else {
        return
    }
    
    // 计算TextField在ScrollView坐标系中的位置
    let textFieldFrameInScroll = activeTextField.convert(activeTextField.bounds, to: yourScrollView)
    // 计算键盘顶部在ScrollView中的Y坐标
    let keyboardTopY = yourScrollView.convert(keyboardFrame.origin, from: nil).y
    // 计算TextField底部的Y坐标
    let textFieldBottomY = textFieldFrameInScroll.origin.y + textFieldFrameInScroll.size.height
    
    // 如果TextField被键盘遮挡，计算需要滚动的距离（加16是留一点呼吸空间）
    if textFieldBottomY > keyboardTopY {
        let scrollOffset = textFieldBottomY - keyboardTopY + 16
        yourScrollView.setContentOffset(CGPoint(x: 0, y: yourScrollView.contentOffset.y + scrollOffset), animated: true)
    }
}

@objc func keyboardWillHide(_ notification: Notification) {
    // 键盘收起时恢复ScrollView的初始位置
    yourScrollView.setContentOffset(CGPoint(x: 0, y: 0), animated: true)
}

第三步：添加获取当前第一响应者的扩展

为了方便拿到正在编辑的TextField，给UIResponder加个小扩展：

extension UIResponder {
    static func currentFirstResponder() -> UIResponder? {
        _currentFirstResponder = nil
        UIApplication.shared.sendAction(#selector(UIResponder.findFirstResponder(_:)), to: nil, from: nil, for: nil)
        return _currentFirstResponder
    }
    
    private static weak var _currentFirstResponder: UIResponder?
    
    @objc private func findFirstResponder(_ sender: Any) {
        UIResponder._currentFirstResponder = self
    }
}

第四步：简化原有的TextField代理方法

现在不需要依赖编辑事件来移动视图了，只保留回收第一响应者的逻辑：

func textFieldShouldReturn(_ textField: UITextField) -> Bool {
    textField.resignFirstResponder()
    return true
}

核心改进点 #

• 动态计算滚动距离：只有当TextField被键盘遮挡时才滚动，且滚动幅度刚好让TextField露出在键盘上方，不会过度移动。
• 操作ScrollView而非整个View：直接调整ScrollView的contentOffset，完全符合ScrollView的使用逻辑，不会影响页面上的其他视图。
• 监听键盘通知：能精准获取键盘的高度和弹出时机，比依赖TextField编辑事件更可靠。

这样修改后，不管是顶部还是底部的TextField，都会根据自身位置和键盘高度自适应滚动，再也不会出现上移过度的问题啦~

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