UITextField输入时每3个字符添加分隔符实现方案咨询

嘿，这个需求我在项目里碰过好多次，比如银行卡号、大额数字的格式化，核心是要在处理输入的同时保证光标位置不乱跳，不然用户体验会很差。下面给你一套完整的实现思路和代码：

核心逻辑 #

通过UITextField的代理方法拦截输入/删除操作，先把现有文本里的分隔符（比如,）去掉，得到纯数字字符串；然后按每3位分组重新添加分隔符；最后还要计算并修正光标位置，避免用户输入时光标跑到奇怪的地方。

完整代码实现（Swift版本） #

1. 先配置TextField #

让ViewController遵守代理，同时设置合适的键盘类型（如果只允许数字输入的话）：

class ViewController: UIViewController, UITextFieldDelegate {
    @IBOutlet weak var targetTextField: UITextField!
    
    override func viewDidLoad() {
        super.viewDidLoad()
        targetTextField.delegate = self
        targetTextField.keyboardType = .numberPad // 限制数字输入，按需调整
    }
}

2. 实现代理方法处理格式化 #

func textField(_ textField: UITextField, shouldChangeCharactersIn range: NSRange, replacementString string: String) -> Bool {
    // 1. 先拿到当前文本，去掉所有分隔符，得到纯数字
    guard let currentText = textField.text else { return true }
    let cleanedText = currentText.replacingOccurrences(of: ",", with: "")
    
    // 2. 处理输入/删除后的纯数字文本
    let newCleanText: String
    if string.isEmpty {
        // 用户在删字符，去掉最后一位
        newCleanText = String(cleanedText.dropLast())
    } else {
        // 用户在输入字符，追加到末尾
        newCleanText = cleanedText + string
    }
    
    // 3. 把纯数字按每3位加分隔符格式化
    let formattedText = formatWithSeparator(newCleanText)
    
    // 4. 计算光标应该在的位置，避免乱跳
    let cursorOffset = calculateCursorOffset(currentText: currentText, newCleanText: newCleanText, range: range)
    
    // 5. 设置格式化后的文本，调整光标位置
    textField.text = formattedText
    if let cursorPosition = textField.position(from: textField.beginningOfDocument, offset: cursorOffset) {
        textField.selectedTextRange = textField.textRange(from: cursorPosition, to: cursorPosition)
    }
    
    // 返回false，因为我们已经手动处理了文本变化
    return false
}

// 辅助方法：给数字字符串加每3位分隔符
private func formatWithSeparator(_ string: String) -> String {
    guard !string.isEmpty else { return "" }
    let reversedStr = String(string.reversed())
    var chunks: [String] = []
    
    // 从后往前每3位分割
    for i in stride(from: 0, to: reversedStr.count, by: 3) {
        let end = min(i + 3, reversedStr.count)
        let chunk = String(reversedStr[reversedStr.index(startIndex, offsetBy: i)..<reversedStr.index(startIndex, offsetBy: end)])
        chunks.append(chunk)
    }
    
    // 反转回来并拼接分隔符
    return chunks.joined(separator: ",").reversed()
}

// 辅助方法：计算光标正确偏移量
private func calculateCursorOffset(currentText: String, newCleanText: String, range: NSRange) -> Int {
    // 原光标位置
    let originalCursorPos = range.location + range.length
    // 原文本里的分隔符数量
    let originalSeparatorCount = currentText.components(separatedBy: ",").count - 1
    // 新格式化文本里的分隔符数量
    let newSeparatorCount = formatWithSeparator(newCleanText).components(separatedBy: ",").count - 1
    
    // 光标位置 = 原光标位置 + 分隔符数量的变化值
    var offset = originalCursorPos + (newSeparatorCount - originalSeparatorCount)
    // 边界处理，防止越界
    offset = max(0, min(offset, formatWithSeparator(newCleanText).count))
    return offset
}

额外说明 #

• 如果需要支持带小数点的金额（比如1234.567变成1,234.567），可以修改cleanedText的过滤逻辑，保留小数点，然后只对小数点前的部分做3位分隔。
• Objective-C版本思路完全一致，只是字符串处理的语法换成OC的NSString方法即可。
• 测试的时候注意删除操作，比如删除分隔符时，代码会自动合并前后数字并重新格式化，不会出现异常。

内容的提问来源于stack exchange，提问作者iOS.Lover