Flutter中如何在文本长度不足时安全截取指定范围的子字符串

原有写死substring(0, 12)的实现存在边界兼容漏洞：Dart内置的substring方法要求传入的结束索引必须小于等于字符串的实际长度，一旦目标文本总长度小于设定的12位阈值，就会直接抛出范围越界的运行时错误。

核心适配逻辑非常简单：计算实际截取的结束索引时，永远取「预设截取长度」和「字符串实际长度」的最小值，从规则上彻底避免索引超出字符串边界。

方案1：基础适配实现 #

不需要额外封装，在原有代码基础上补充长度判断即可：

// 目标渲染文本
String targetText = 'simply dummy text for printing ';
// 预设截取阈值为12
const int cutThreshold = 12;
// 计算不会越界的有效结束索引
final validEndIndex = targetText.length < cutThreshold ? targetText.length : cutThreshold;

// 传入Text组件正常渲染
Text(
  targetText.substring(0, validEndIndex),
)

方案2：通用可复用封装 #

如果项目内多个页面都需要实现这类截断逻辑，可以给String类扩展通用的安全截断方法，避免重复编写判断逻辑：

extension SafeCutString on String {
  /// 安全截取指定前缀长度，文本不足设定长度时直接返回完整内容
  String safeCut(int maxLength) {
    if (isEmpty) return '';
    final endIndex = length < maxLength ? length : maxLength;
    return substring(0, endIndex);
  }
}

// 实际使用时直接链式调用，代码更简洁
Text(
  'simply dummy text for printing '.safeCut(12),
)

适配后的实际效果 #

• 当文本总长度≥12时，正常返回前12位内容，和原有逻辑表现完全一致
• 当文本总长度<12时，直接返回完整文本，完全不会触发索引越界报错

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