修改UIScrollView的contentInset后contentOffset出现延迟自动动画问题

你已经找对了核心实现思路，这个延迟动画的问题大多是系统自动调整contentOffset和自定义动画冲突导致的，下面给你一套能彻底解决问题的完整方案：

问题根源 #

默认情况下，UIScrollView的contentInsetAdjustmentBehavior是.automatic，当你修改contentInset时，系统会自动触发contentOffset的调整动画，这个系统动画会和你手动写的contentOffset动画重叠，最终就出现了延迟、跳变的怪异效果。

解决步骤 #

1. 禁用系统自动调整contentOffset
   在viewDidLoad里把scrollView的调整行为改成手动控制，切断系统的自动干预：

scrollView.contentInsetAdjustmentBehavior = .never

2. 监听键盘Will通知而非Did通知
   改用UIKeyboardWillShowNotification和UIKeyboardWillHideNotification，让你的动画和键盘弹出/收起的动画完全同步，从根源避免时机差导致的延迟。

3. 同步动画参数，精确计算偏移量
   获取键盘动画的时长和曲线，用完全一致的参数执行scrollView的动画；同时基于输入框在scrollView内的相对位置计算偏移量，确保输入框刚好落在键盘上方。

完整代码示例（Swift） #

class YourFormViewController: UIViewController {
    @IBOutlet weak var scrollView: UIScrollView!
    
    override func viewDidLoad() {
        super.viewDidLoad()
        // 禁用系统自动调整contentOffset
        scrollView.contentInsetAdjustmentBehavior = .never
        // 注册键盘通知
        NotificationCenter.default.addObserver(self, selector: #selector(keyboardWillShow(_:)), name: UIResponder.keyboardWillShowNotification, object: nil)
        NotificationCenter.default.addObserver(self, selector: #selector(keyboardWillHide(_:)), name: UIResponder.keyboardWillHideNotification, object: nil)
    }
    
    @objc private func keyboardWillShow(_ notification: Notification) {
        guard let userInfo = notification.userInfo,
              let keyboardFrame = userInfo[UIResponder.keyboardFrameEndUserInfoKey] as? CGRect,
              let duration = userInfo[UIResponder.keyboardAnimationDurationUserInfoKey] as? TimeInterval,
              let curve = userInfo[UIResponder.keyboardAnimationCurveUserInfoKey] as? UInt,
              let activeTextField = UIResponder.currentFirstResponder() as? UITextField else {
            return
        }
        
        // 计算输入框在scrollView中的相对位置
        let textFieldFrameInScroll = scrollView.convert(activeTextField.bounds, from: activeTextField)
        // 给输入框留16pt的间距，避免紧贴键盘
        let textFieldBottom = textFieldFrameInScroll.origin.y + textFieldFrameInScroll.height + 16
        // 计算需要滚动的距离
        let scrollDiff = textFieldBottom - scrollView.bounds.height
        
        // 设置新的contentInset和滚动指示器inset
        let newInset = UIEdgeInsets(top: 0, left: 0, bottom: keyboardFrame.height, right: 0)
        
        // 用和键盘一致的动画参数执行动画
        UIView.animate(withDuration: duration, delay: 0, options: UIView.AnimationOptions(rawValue: curve)) {
            self.scrollView.contentInset = newInset
            self.scrollView.scrollIndicatorInsets = newInset
            // 只有当需要滚动时才调整contentOffset
            if scrollDiff > 0 {
                self.scrollView.contentOffset = CGPoint(x: 0, y: self.scrollView.contentOffset.y + scrollDiff)
            }
        }
    }
    
    @objc private func keyboardWillHide(_ notification: Notification) {
        guard let userInfo = notification.userInfo,
              let duration = userInfo[UIResponder.keyboardAnimationDurationUserInfoKey] as? TimeInterval,
              let curve = userInfo[UIResponder.keyboardAnimationCurveUserInfoKey] as? UInt else {
            return
        }
        
        // 恢复原有的contentInset
        let originalInset = UIEdgeInsets.zero
        UIView.animate(withDuration: duration, delay: 0, options: UIView.AnimationOptions(rawValue: curve)) {
            self.scrollView.contentInset = originalInset
            self.scrollView.scrollIndicatorInsets = originalInset
            // 可选：如果需要回到表单顶部，取消下面的注释
            // self.scrollView.contentOffset = .zero
        }
    }
    
    // 记得在页面销毁时移除通知监听
    deinit {
        NotificationCenter.default.removeObserver(self)
    }
}

// 扩展UIResponder，方便获取当前正在编辑的输入框
extension UIResponder {
    static func currentFirstResponder() -> UIResponder? {
        _currentFirstResponder = nil
        UIApplication.shared.sendAction(#selector(findFirstResponder(_:)), to: nil, from: nil, for: nil)
        return _currentFirstResponder
    }
    
    private static weak var _currentFirstResponder: UIResponder?
    
    @objc private func findFirstResponder(_ sender: Any) {
        UIResponder._currentFirstResponder = self
    }
}

关键细节说明 #

• 禁用自动调整：这是解决延迟动画的核心，让scrollView的contentOffset完全由我们手动控制，彻底避免系统的自动干预。
• 同步动画参数：用键盘的动画时长和曲线，保证滚动动画和键盘弹出/收起的节奏完全一致，不会出现脱节感。
• 精确计算偏移：基于输入框在scrollView内的相对位置计算偏移，比屏幕绝对frame更可靠，尤其是scrollView本身已经有偏移的场景。

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