如何解决UITextField中日文等多阶段输入的格式兼容问题

核心原因 #

直接在.editingChanged事件中替换attributedText会打断日文（及中文拼音、韩文等）的**未提交输入（Marked Text）**状态——用户正在组合字符（如输入し+゛生成じ）时，文本框处于临时输入状态，强制替换文本会重置该状态，导致组合失败。

解决方案 #

方案1：跳过未提交输入阶段再格式化 #

通过判断textField.markedTextRange是否为nil，只在用户完成字符输入（临时输入状态结束）后执行富文本格式化：

@objc private func textFieldDidChange(_ textField: UITextField) {
    // 存在未提交的多阶段输入时，跳过格式化逻辑
    guard textField.markedTextRange == nil else { return }
    
    // 记录光标位置，避免设置富文本后光标偏移
    let cursorRange = textField.selectedTextRange
    
    // 应用常规富文本格式
    textField.attributedText = viewModel.standardAttributedText(text: textField.text)
    
    // 恢复光标位置
    if let range = cursorRange {
        textField.selectedTextRange = range
    }
}

方案2：适配高亮状态的实时触发 #

如果需要随时触发高亮状态，处理时需保留未提交输入的状态，避免打断输入流程：

func applyHighlightStyle() {
    guard let currentText = textField.text else { return }
    
    // 保存当前未提交输入的范围和光标位置
    let markedRange = textField.markedTextRange
    let cursorPosition = textField.selectedTextRange
    
    // 应用高亮富文本格式
    textField.attributedText = viewModel.highlightAttributedText(text: currentText)
    
    // 恢复未提交输入的选中状态
    if let validMarkedRange = markedRange,
       let newMarkedRange = textField.textRange(from: validMarkedRange.start, to: validMarkedRange.end) {
        textField.selectedTextRange = newMarkedRange
    } else if let validCursorPosition = cursorPosition {
        textField.selectedTextRange = validCursorPosition
    }
}

补充说明 #

• markedTextRange是系统用来标记未提交输入的属性，所有多阶段输入场景（日文、中文拼音、韩文等）都会触发该状态。
• 直接替换attributedText会重置文本框的内部状态，包括光标位置和未提交输入，因此必须在合适的时机执行，并恢复光标位置。

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