Flutter Text组件溢出异常：忽略可用空间未正确截断

问题分析 #

你的问题核心出在两点：

• 未设置maxLines时，Text默认采用包裹宽度布局，文本不会自动换行，仅在超出屏幕宽度时被截断为单行。
• 设置过大的maxLines值时，Text会优先尝试渲染指定行数，完全忽略父容器的高度限制，导致内容溢出容器边界。

解决代码示例 #

修改后的代码可同时解决两个问题，让文本在固定高度容器内自动换行，超出部分显示省略号：

@override
Widget build(BuildContext context) {
  return MaterialApp(
    home: SafeArea(
      child: Material(
        child: Column(
          children: [
            Container(
              color: Colors.black12,
              height: 100,
              width: double.infinity, // 让容器填满父级宽度，给Text提供换行约束
              child: Text(
                'dsf sdf ds fs dfsdfdf  iuh gyj gy y'
                    ' guygiukjh  uiygihjo; rdtfyguhijok rftyguhij yguhij'
                    'dsf sdf ds fs dfsdfdf  iuh gyj gy y'
                    ' guygiukjh  uiygihjo; rdtfyguhijok rftyguhij yguhij'
                    'dsf sdf ds fs dfsdfdf  iuh gyj gy y'
                    ' guygiukjh  uiygihjo; rdtfyguhijok rftyguhij yguhij'
                    'dsf sdf ds fs dfsdfdf  iuh gyj gy y'
                    ' guygiukjh  uiygihjo; rdtfyguhijok rftyguhij yguhij'
                    'dsf sdf ds fs dfsdfdf  iuh gyj gy y'
                    ' guygiukjh  uiygihjo; rdtfyguhijok rftyguhij yguhij',
                overflow: TextOverflow.ellipsis,
                softWrap: true, // 允许自动换行（默认值，显式声明更清晰）
                maxLines: null, // 不硬编码行数，让Flutter根据容器高度自动适配
              ),
            ),
          ],
        ),
      ),
    ),
  );
}

关键修改说明 #

1. 添加宽度约束：给Container设置width: double.infinity，让容器填满父级宽度，Text因此获得明确的宽度限制，文本会自动在单词边界换行。
2. 移除不合理的行数设置：将maxLines设为null（或直接删除该属性），Flutter会根据Container的高度自动计算能容纳的最大行数，超出部分触发TextOverflow.ellipsis显示省略号。

替代方案：用Flexible/Expanded适配布局 #

如果Container需要在Column中自适应宽度，可使用Expanded包裹Text，同样能给Text提供宽度约束：

Container(
  color: Colors.black12,
  height: 100,
  child: Expanded(
    child: Text(
      // ...文本内容
      overflow: TextOverflow.ellipsis,
      softWrap: true,
      maxLines: null,
    ),
  ),
)

注意事项 #

• softWrap: true是默认值，但如果之前被手动设为false，文本会强制单行显示，即使有宽度约束，需确保该属性正确设置。
• 若必须精确控制行数，需先结合文本字号、行高计算容器能容纳的行数，再设置对应的maxLines值，避免超过容器承载范围。

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