Android：EditText需基于尺寸而非字符数设置最大输入长度

常规的editText.maxLength = "21"按字符数限制输入的方式，在字符宽度差异大的场景下（比如混合全角/半角字符、特殊大字体字符）会失效，导致内容超出EditText边框。以下是基于EditText实际可用宽度，以基准字符宽度为参考的动态限制方案：

实现思路 #

1. 计算EditText的可用显示宽度（总宽度减去左右padding）
2. 以指定基准字符（如'M'，拉丁字符中宽度较大；中文场景可选'中'）的宽度为参考，算出理论最大可容纳字符数
3. 通过TextWatcher实时监听输入内容的宽度，超过可用宽度时自动截断

代码实现（Kotlin） #

// 确保在EditText布局完成后执行（比如onViewCreated、onWindowFocusChanged中）
editText.viewTreeObserver.addOnGlobalLayoutListener(object : ViewTreeObserver.OnGlobalLayoutListener {
    override fun onGlobalLayout() {
        // 移除监听避免重复执行
        editText.viewTreeObserver.removeOnGlobalLayoutListener(this)
        
        // 1. 计算EditText可用宽度
        val availableWidth = editText.width - editText.paddingLeft - editText.paddingRight
        if (availableWidth <= 0) return
        
        // 2. 获取基准字符的宽度（用EditText当前的Paint测量）
        val paint = editText.paint
        val baseCharWidth = paint.measureText("M").toInt()
        if (baseCharWidth <= 0) return
        
        // 3. 计算理论最大字符数，减1留余量避免刚好卡边框
        var maxCharCount = availableWidth / baseCharWidth - 1
        maxCharCount = maxCharCount.coerceAtLeast(1) // 至少允许输入1个字符
        
        // 4. 设置TextWatcher实时监听并截断内容
        editText.addTextChangedListener(object : TextWatcher {
            override fun beforeTextChanged(s: CharSequence?, start: Int, count: Int, after: Int) {}

            override fun onTextChanged(s: CharSequence?, start: Int, before: Int, count: Int) {}

            override fun afterTextChanged(s: Editable?) {
                s?.let { editable ->
                    val currentText = editable.toString()
                    val currentWidth = paint.measureText(currentText).toInt()
                    
                    if (currentWidth > availableWidth) {
                        // 先按理论最大数截断，再循环调整直到宽度符合
                        var truncatedText = currentText.substring(0, maxCharCount)
                        while (paint.measureText(truncatedText).toInt() > availableWidth && truncatedText.isNotEmpty()) {
                            truncatedText = truncatedText.substring(0, truncatedText.length - 1)
                        }
                        // 避免触发无限循环，先移除监听再设置文本
                        editText.removeTextChangedListener(this)
                        editText.setText(truncatedText)
                        editText.setSelection(truncatedText.length)
                        editText.addTextChangedListener(this)
                    }
                }
            }
        })
    }
})

注意事项 #

• 必须在EditText布局完成后执行代码，否则无法获取正确的宽度值
• 若EditText宽度为wrap_content，此方案不适用（因为宽度会随内容动态变化）
• 中文场景可将基准字符改为'中'，更符合实际字符宽度分布
• 若存在动态切换字体的场景，需重新计算基准字符宽度和最大字符数

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