Compose TextField自动换行不计入行数，如何限制最大行数？

你的问题核心在于：maxLines仅控制TextField的显示行数（超出内容会被裁剪或滚动），而按\n分割统计行数的方式只识别手动换行，无法捕获文本自动换行产生的行数，导致实际输入内容能突破行数限制。

有效解决方案：利用onTextLayout回调获取实际行数 #

Jetpack Compose提供了onTextLayout回调，能在文本完成布局后返回包含实际行数的TextLayoutResult，我们可以通过这个回调来实时监控并限制输入行数。

修改后的代码示例：

var textState by remember { mutableStateOf(TextFieldValue("")) }
val maxLines = 3
var textLayoutResult by remember { mutableStateOf<TextLayoutResult?>(null) }

BasicTextField(
    modifier = Modifier
        .fillMaxWidth()
        .onFocusChanged { isFocused = it.isFocused },
    value = textState,
    onValueChange = { newText ->
        // 先临时更新文本，触发布局计算
        textState = newText
        // 布局完成后检查实际行数
        textLayoutResult?.let { layoutResult ->
            if (layoutResult.lineCount > maxLines) {
                // 行数超限，回滚到上一个有效文本
                textState = textState.copy(text = textState.text.dropLast(1))
                onTextChanged(textState.text)
            } else {
                onTextChanged(newText.text)
            }
        } ?: run {
            // 布局未完成时，先同步输入（后续布局回调会做二次校验）
            onTextChanged(newText.text)
        }
    },
    maxLines = maxLines,
    onTextLayout = { layoutResult ->
        textLayoutResult = layoutResult
        // 二次校验：防止某些场景下的行数超限
        if (layoutResult.lineCount > maxLines) {
            textState = textState.copy(text = textState.text.dropLast(1))
            onTextChanged(textState.text)
        }
    }
) { innerTextField ->
    innerTextField()
}

方案说明 #

1. onTextLayout的作用：每次文本布局完成后触发，返回的TextLayoutResult.lineCount包含了手动换行+自动换行的总行数，是最准确的行数统计依据。
2. 双向校验逻辑：
   • 在onValueChange中先临时更新文本，等待布局完成后检查行数，超限则回滚。
   • 在onTextLayout中再次校验，避免因布局延迟导致的遗漏。
3. 体验说明：虽然会有轻微的“字符闪回”（输入后立刻被删除），但这是目前官方未提供直接限制输入行数API情况下的最优实现方式。

为什么不推荐字符数估算方案？ #

你提到的通过宽度、字体大小估算每行字符数的方案存在诸多问题：

• 不同字符的宽度差异大（比如中文与英文、全角与半角），估算误差明显。
• 字体样式（加粗、斜体）、屏幕密度、布局内边距等因素都会影响实际每行容纳的字符数，维护成本极高。

内容的提问来源于stack exchange，提问作者P.Juni