Flutter Text组件设maxLines与ellipsis后多行换行不显示省略号问题

Flutter 原生 Text 组件的省略号逻辑仅对软换行截断场景生效：当文本包含 \n 手动硬换行符时，组件会将每个换行分隔的内容识别为独立硬行，一旦展示行数达到 maxLines 阈值被强制截断，不会在截断位置自动追加省略标识；只有文本因长度超出行宽触发自动软折行导致的截断，才会正常展示 TextOverflow.ellipsis 的效果。

方案1：手动预截断轻量实现 #

适合文本行宽度固定、不会触发自动软折行的简单场景，保留原有换行格式，直接在代码层处理截断逻辑：

• 将原始文本按 \n 拆分为独立行列表
• 若拆分后的行数 ≤ 设置的最大行数，直接展示原始文本
• 若拆分后的行数超出最大行数，截取对应内容后在指定位置追加省略符：可选择将省略符跟在最后一行末尾，也可单独占最后一行展示

核心示例代码：

// 实现省略符跟在第三行末尾的效果
String buildTruncatedText(String originalText, int maxLines) {
  final lineList = originalText.split('\n');
  if (lineList.length <= maxLines) return originalText;
  final keepContent = lineList.sublist(0, maxLines - 1).join('\n');
  final lastLineContent = lineList[maxLines - 1];
  return '$keepContent\n$lastLineContent...';
}

// 调用方式
Text(buildTruncatedText(text, 3))

该方案的局限：如果某一单行内容长度超出组件宽度触发自动折行，会导致实际展示行数超出预期。

方案2：基于 TextPainter 精准计算截断位置 #

适合复杂文本场景，可同时兼容手动换行、超长行自动折行的情况，精准匹配截断逻辑：

• 用 LayoutBuilder 获取组件可用的最大展示宽度
• 初始化 TextPainter 传入对应文本样式、最大行数，对原始文本做布局测量
• 判断文本是否超出最大行数：未超出则直接返回原文展示；超出则获取截断位置对应的文本索引，在索引位置插入省略符后传给 Text 组件展示

核心示例代码：

LayoutBuilder(
  builder: (context, constraints) {
    const textStyle = TextStyle(fontSize: 14);
    const maxLines = 3;
    // 测量文本布局
    final textPainter = TextPainter(
      text: TextSpan(text: originalText, style: textStyle),
      maxLines: maxLines,
      textDirection: TextDirection.ltr,
    )..layout(maxWidth: constraints.maxWidth);

    String displayContent = originalText;
    if (textPainter.didExceedMaxLines) {
      // 获取文本末尾位置被截断时的坐标偏移
      final caretOffset = textPainter.getOffsetForCaret(
        TextPosition(offset: textPainter.plainText.text.length),
        Rect.zero,
      );
      // 定位截断位置对应的文本索引
      final truncatePosition = textPainter.getPositionForOffset(caretOffset).offset;
      // 拼接带省略符的文本，需要省略符单独占行时可在截断位置后拼接'\n...'
      displayContent = '${originalText.substring(0, truncatePosition)}...';
    }

    return Text(displayContent, style: textStyle);
  },
)

注意：计算截断索引时，需要为省略符预留对应宽度的字符空间，避免省略符触发额外折行导致展示行数超出预期。
该方案可完全复现原生文本的换行逻辑，不会出现行数计算偏差，同时支持自定义省略符的位置、样式。

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