本文介绍如何使用正则表达式实现对 twitter/slack 风格用户名（如 `@john`、`@john.doe`）的**精确匹配替换**，防止因子串重叠（如 `@john` 被 `@john.doe` 包含）导致的错误替换。

在处理社交平台类文本（如提及用户 @username）时，一个常见陷阱是：简单使用 String.prototype.replace() 按顺序替换所有用户名，会导致短用户名（如 @john）被长用户名（如 @

let text = 'Hi @john.doe, i see @john has tagged you';
text = text.replace('@john', '@john(2)');     // ❌ 错误：也替换了 '@john.doe' 中的 '@john'
text = text.replace('@john.doe', '@john.doe(1)'); // 此时 '@john.doe' 已被破坏
// 结果可能变成：'Hi @john(2).doe(1), i see @john(2)(2) has tagged you' —— 完全错误

✅ 正确解法是：对每个用户名构造具备“单词边界语义”的正则表达式，确保仅匹配完整、独立的 @username 实体。

关键在于使用负向先行断言（negative lookahead） 和正向先行断言（positive lookahead） 来定义用户名的合法结束条件：

• 用户名后不能紧跟字母、数字、点、下划线或连字符（即 (?![a-z0-9_.-])），防止匹配 @john.doe 中的 @john；
• 同时需允许用户名后直接跟英文句号（如 @john. 末尾标点），此时应仍视为有效匹配（(?=\.$)）；

以下为健壮、可复用的实现方案：

function replaceUsernames(text, usernameMap) {
  // usernameMap: Map，键为用户名（不含@），值为ID
  let result = text;

  // 按用户名长度**降序排列**，优先匹配更长的用户名（防覆盖）
  const sortedEntries = [...usernameMap.entries()]
    .sort((a, b) => b[0].length - a[0].length);

  for (const [username, userId] of sortedEntries) {
    // 构造正则：@username 后必须是非标识符字符（或行尾/标点）
    const escapedUsername = username.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'); // 转义正则特殊字符
    const regex = new RegExp(`@${escapedUsername}(?![a-z0-9_.-]|$)|@${escapedUsername}(?=\.$)`, 'gi');

    result = result.replace(regex, `${username}(${userId})`);
  }

  return result;
}

// 使用示例
const text = 'Hi @john.doe, i see @john has tagged you. Also check @alice.cooper and @alice!';
const map = new Map([
  ['john.doe', 1],
  ['john', 2],
  ['alice.cooper', 3],
  ['alice', 4]
]);

console.log(replaceUsernames(text, map));
// 输出：Hi john.doe(1), i see john(2) has tagged you. Also check alice.cooper(3) and alice(4)!

? 重要注意事项：

• ✅ 务必按用户名长度降序处理：先替换 @john.doe，再替换 @john，否则短名会污染长名；
• ✅ 对用户名内容做正则转义：若用户名含 .、* 等特殊字符（如 @user.name），不转义将导致正则语法错误；
• ✅ 使用全局标志 g 和忽略大小写 i（如需支持 @JOHN）；
• ⚠️ 当前逻辑假设用户名只含 ASCII 字母、数字及 ._-；如需支持 Unicode（如中文用户名），可将 [a-z0-9_.-] 扩展为 \p{L}\p{N}_\- 并添加 u 标志（需现代环境支持）；
• ? 若需保留 @ 符号（如输出 @john(2)），只需将替换字符串改为 @${username}(${userId})。

该方法兼顾准确性、可维护性与性能，适用于评论解析、消息高亮、Mention 提取等真实业务场景。