UITextField光标悬浮于placeholder上方异常问题求助

首先排查最可能的原因：你的OTP输入框没有调用setStyle()方法，而其他正常的UITextField都调用了这个方法来统一设置字体、文本对齐等样式。光标位置会依赖TextField的字体和文本布局，缺少这些样式设置会导致光标偏移。

解决方案1：补充调用setStyle() #

修改setupOTPField()方法，给otpField添加样式设置：

private func setupOTPField() {
    otpField.keyboardType = .numberPad
    otpField.returnKeyType = .continue
    otpField.placeholder = OTP_FIELD_PLACEHOLDER
    otpField.setStyle() // 新增这行
    self.addSubview(otpField)
}

如果已经调用了setStyle()，尝试以下方案 #

方案2：强制Placeholder与TextField字体一致 #

有时候系统默认的Placeholder可能因为版本或布局问题，字体和TextField的font不匹配，手动设置富文本Placeholder来对齐：

// 在setupOTPField里添加
let placeholderAttr = NSAttributedString(
    string: OTP_FIELD_PLACEHOLDER,
    attributes: [
        .font: UIFont.systemFont(ofSize: FONT_SIZE),
        .foregroundColor: UIColor.placeholderText
    ]
)
otpField.attributedPlaceholder = placeholderAttr

方案3：修复底部边框的布局计算问题 #

你的addBottomBorder()方法使用了self.frame.size.height来计算边框位置，但在Auto Layout环境下，视图的frame可能还未完成布局就被调用，导致边框位置错误，间接影响TextField的内部光标布局。修改为在layoutSubviews中更新边框frame：

extension UITextField {
    func addBottomBorder() {
        let bottomLine = CALayer()
        bottomLine.name = "BottomBorder"
        // 先移除旧边框，避免重复添加
        layer.sublayers?.filter { $0.name == "BottomBorder" }.forEach { $0.removeFromSuperlayer() }
        
        bottomLine.backgroundColor = traitCollection.userInterfaceStyle == .dark 
            ? BOTTOM_BORDER_COLOR_DARK_MODE 
            : BOTTOM_BORDER_COLOR
        layer.addSublayer(bottomLine)
    }
    
    override open func layoutSubviews() {
        super.layoutSubviews()
        // 在布局更新时同步边框位置
        layer.sublayers?.filter { $0.name == "BottomBorder" }.forEach {
            $0.frame = CGRect(
                x: 0,
                y: frame.height - BOTTOM_BORDER_HEIGHT,
                width: frame.width,
                height: BOTTOM_BORDER_HEIGHT
            )
        }
    }
    
    func setStyle() {
        addBottomBorder()
        font = .systemFont(ofSize: FONT_SIZE)
        backgroundColor = BACKGROUND_COLOR
        textAlignment = .center
    }
}

方案4：检查是否存在其他布局干扰 #

• 确认otpField的Auto Layout约束是否正确，尤其是高度约束，避免TextField高度异常导致光标偏移
• 排查是否有其他Category、子类或第三方库修改了UITextField的contentVerticalAlignment、contentInset等属性，这些都会影响光标位置

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