UITextField首次点击光标不显示问题排查与解决求助

我在自定义Cell中放置了3个UITextField，三者配置仅名称不同。其中repsTextField和rpeTextField运行正常——首次点击时光标显示且键盘弹出；但weightTextField存在异常：首次点击时光标不显示，键盘正常弹出，输入首个字符后光标才出现。

var currentWorkoutSet: WorkoutSet!

@IBOutlet weak var setNumLabel: UILabel!
@IBOutlet weak var repsTextField: UITextField!
@IBOutlet weak var weightTextField: UITextField!
@IBOutlet weak var rpeTextField: UITextField!

static let identifier = "WorkoutViewCell"

static func nib() -> UINib {
    return UINib(nibName: "WorkoutViewCell", bundle: nil)
}

override func awakeFromNib() {
    super.awakeFromNib()
    
    // Initialization code
    if let item = currentWorkoutSet {
        item.reps = 0
        item.weight = 0.0
        item.rpe = 0.0
    }
    initTextFields()
}

func initTextFields() {
    repsTextField.keyboardType = UIKeyboardType.decimalPad
    weightTextField.keyboardType = UIKeyboardType.decimalPad
    rpeTextField.keyboardType = UIKeyboardType.decimalPad
}

已尝试的排查步骤：

• 重置文本框IBOutlet连线
• 对比三个TextField的Storyboard配置项
• 检查Storyboard中Cell和TextField的层级、约束设置
• 查阅相关文档

排查方向与解决方法 #

1. 初始化TextField文本状态 #

空文本的默认状态可能导致光标渲染异常，可在初始化时显式设置空字符串：

func initTextFields() {
    repsTextField.keyboardType = .decimalPad
    weightTextField.keyboardType = .decimalPad
    rpeTextField.keyboardType = .decimalPad
    
    // 显式设置空文本，避免默认nil状态的渲染问题
    weightTextField.text = ""
}

2. 手动强制触发光标显示 #

在TextField开始编辑时，手动设置光标位置或重新响应第一响应者：

override func awakeFromNib() {
    super.awakeFromNib()
    
    if let item = currentWorkoutSet {
        item.reps = 0
        item.weight = 0.0
        item.rpe = 0.0
    }
    initTextFields()
    
    // 添加编辑开始监听
    weightTextField.addTarget(self, action: #selector(handleWeightFieldEditStart), for: .editingDidBegin)
}

@objc private func handleWeightFieldEditStart(_ textField: UITextField) {
    // 强制设置光标到起始位置
    textField.selectedTextRange = textField.textRange(from: textField.beginningOfDocument, to: textField.beginningOfDocument)
    // 或者延迟重新触发第一响应者
    DispatchQueue.main.async {
        textField.becomeFirstResponder()
    }
}

3. 调整数据加载时机 #

awakeFromNib时currentWorkoutSet可能未完成赋值，导致TextField初始化逻辑异常。将数据配置移到专门方法中，在TableView的cellForRowAt里调用：

func configure(with workoutSet: WorkoutSet) {
    currentWorkoutSet = workoutSet
    currentWorkoutSet.reps = 0
    currentWorkoutSet.weight = 0.0
    currentWorkoutSet.rpe = 0.0
    
    // 同步更新TextField显示
    repsTextField.text = "\(currentWorkoutSet.reps)"
    weightTextField.text = "\(currentWorkoutSet.weight)"
    rpeTextField.text = "\(currentWorkoutSet.rpe)"
}

4. 检查布局与层级问题 #

• 开启Debug View Hierarchy，确认weightTextField没有被其他视图遮挡
• 检查TextField的宽度约束是否正常，避免宽度为0或过小导致光标不可见
• 统一光标颜色，确保和正常TextField一致：weightTextField.tintColor = repsTextField.tintColor

5. 重置TextField属性 #

尝试重置可能影响光标渲染的属性：

func initTextFields() {
    // ... 原有代码
    
    weightTextField.clearsOnBeginEditing = false
    weightTextField.clearButtonMode = .whileEditing
    weightTextField.textAlignment = .left // 确保文本对齐方式正常
}

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