键盘弹出时UITextField跳出UIImageView的问题求助

1. 关闭ScrollView的自动键盘适配 #

系统默认会在键盘弹出时自动调整UIScrollView的内容偏移和内边距，这是导致文本框跳出ImageView的核心原因之一。直接禁用该行为：

// 代码实现
scrollView.contentInsetAdjustmentBehavior = .never

或者在Storyboard中选中ScrollView，在「属性检查器」里将「Content Inset」设置为「Never」。

2. 检查UITextField的约束设置 #

确保UITextField的约束完全基于父视图UIImageView，而非ScrollView或控制器的安全区域：

• 绑定文本框的顶部约束到UIImageView的topAnchor
• 绑定左右约束到UIImageView的leading/trailingAnchor
• 固定文本框的高度约束
  避免使用跨层级的约束，否则键盘弹出时的布局计算会出现偏差。

3. 手动管理键盘弹出/收起的ScrollView内边距 #

如果禁用自动适配后文本框被键盘遮挡，可通过监听键盘通知调整ScrollView的内边距，而非直接移动ScrollView：

override func viewDidLoad() {
    super.viewDidLoad()
    // 注册键盘通知
    NotificationCenter.default.addObserver(self, selector: #selector(onKeyboardShow), name: UIResponder.keyboardWillShowNotification, object: nil)
    NotificationCenter.default.addObserver(self, selector: #selector(onKeyboardHide), name: UIResponder.keyboardWillHideNotification, object: nil)
}

@objc private func onKeyboardShow(notification: NSNotification) {
    guard let keyboardRect = notification.userInfo?[UIResponder.keyboardFrameEndUserInfoKey] as? CGRect else { return }
    let keyboardHeight = keyboardRect.height
    // 调整ScrollView内边距，留出键盘空间
    scrollView.contentInset = UIEdgeInsets(top: 0, left: 0, bottom: keyboardHeight, right: 0)
    scrollView.scrollIndicatorInsets = scrollView.contentInset
}

@objc private func onKeyboardHide(notification: NSNotification) {
    // 恢复内边距
    scrollView.contentInset = .zero
    scrollView.scrollIndicatorInsets = .zero
}

deinit {
    // 移除通知监听
    NotificationCenter.default.removeObserver(self)
}

这种方式仅扩展ScrollView的可滚动区域，不会改变UIImageView与UITextField的相对位置。

4. 修正UIImageView在ScrollView中的约束 #

UIImageView作为ScrollView的子视图，必须设置明确约束以定义ScrollView的内容尺寸：

• 将UIImageView的top、leading、trailing、bottom约束绑定到ScrollView的contentLayoutGuide
• 添加UIImageView的宽度约束等于ScrollView的frameLayoutGuide宽度（如果不需要横向滚动）
  这样ScrollView的contentSize会与UIImageView尺寸完全匹配，避免布局计算混乱。

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