Flutter社交应用中带空格非唯一用户名@提及功能实现问题

核心问题在于纯文本本身无法区分重复的用户名，必须从「用户选择提及对象的环节」就记录每个提及的唯一标识，而不是事后靠文本匹配。以下是几个可行的解决方案：

方案一：基于文本位置的精准跟踪（推荐） #

在用户选择@某人时，同步记录该提及在文本中的位置（起始/结束索引）以及对应的用户ID，而不是只存用户名和ID的映射。

1. 定义一个类来存储单个提及的信息：

class Mention {
  final int startIndex; // 提及文本在原字符串中的起始索引
  final int endIndex;   // 提及文本在原字符串中的结束索引
  final String userId;  // 对应用户的唯一ID
  final String userName;// 显示的用户名（如John Doe）

  Mention({
    required this.startIndex,
    required this.endIndex,
    required this.userId,
    required this.userName,
  });
}

2. 用户每次选择提及对象时，将该提及的位置和ID添加到List<Mention>列表中。注意：如果用户编辑文本（插入/删除内容），需要同步更新列表中所有提及的索引（可以通过监听TextEditingController的变化来实现）。

3. 生成后端需要的格式时，从后往前遍历提及列表（避免替换前面的内容导致后面的索引偏移），逐个替换对应位置的文本：

String convertToBackendFormat(String originalText, List<Mention> mentions) {
  String result = originalText;
  // 按起始索引倒序排列，防止替换后索引失效
  final sortedMentions = List.from(mentions)..sort((a, b) => b.startIndex.compareTo(a.startIndex));

  for (final mention in sortedMentions) {
    // 替换成@{UserName:UserId}格式
    final replacement = "@{${mention.userName}:${mention.userId}}";
    result = result.replaceRange(mention.startIndex, mention.endIndex, replacement);
  }
  return result;
}

这个方案完全精准，不会因为用户名重复搞混ID，是最可靠的实现方式。如果使用富文本编辑器（如flutter_quill），很多编辑器自带了提及的位置跟踪能力，可以直接复用。

方案二：使用临时唯一标记替代 #

用户选择提及对象时，不在文本中直接插入用户名，而是插入一个临时的唯一标记（如UUID），同时维护标记与用户信息的映射。

1. 定义存储用户信息的类：

class MentionData {
  final String userName;
  final String userId;

  MentionData({required this.userName, required this.userId});
}

2. 用户选择@某人时，生成一个临时标记（如temp_${UUID().v4()}），插入到文本中，同时把标记和用户信息存入Map<String, MentionData>。

3. 在UI显示时，把临时标记替换成真实用户名展示（可以用TextSpan或富文本组件实现）；发送给后端前，再把临时标记替换成目标格式：

String convertWithTempTags(String textWithTempTags, Map<String, MentionData> tempTagMap) {
  String result = textWithTempTags;
  tempTagMap.forEach((tempTag, data) {
    result = result.replaceAll("@[$tempTag]", "@{${data.userName}:${data.userId}}");
  });
  return result;
}

这个方案不需要处理文本编辑时的索引偏移问题，适合对文本编辑逻辑不想做复杂处理的场景，只要保证临时标记足够唯一即可。

方案三：按匹配顺序替换（仅适用于无编辑场景） #

如果文本是一次性输入完成，后续不会修改，可以记录用户选择提及的顺序，然后按正则匹配的顺序依次替换ID：

String convertWithOrder(String originalText, List<String> orderedUserIds, List<String> userNames) {
  int matchIndex = 0;
  return originalText.splitMapJoin(
    RegExp(r'@[\w\s]+'), // 匹配带空格的@提及
    onMatch: (Match m) {
      if (matchIndex < orderedUserIds.length) {
        final userId = orderedUserIds[matchIndex];
        final userName = userNames[matchIndex];
        matchIndex++;
        return "@{${userName}:${userId}}";
      }
      return m[0]!;
    },
  );
}

注意：这个方案的局限性很大，一旦用户调整提及顺序或编辑文本，就会导致ID匹配错误，仅适合简单的一次性输入场景。

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