本文介绍如何使用正则表达式实现对 twitter/slack 风格用户名（如 `@john`、`@john.doe`）的**精确匹配替换**，防止因子串重叠（如 `@john` 被 `@john.doe` 包含）导致的错误替换。
在处理社交平台类文本（如提及用户 @username）时，一个常见陷阱是：简单使用 String.prototype.replace() 按顺序替换所有用户名，会导致短用户名（如 @john）被长用户名（如 @john.doe）中的前缀意外匹配，从而引发重复替换或格式错乱。例如：
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. 末尾标点），此时应仍视为有效匹配（(?=.$)）；
以下为健壮、可复用的实现方案：
立即学习“Java免费学习笔记（深入）”；
function replaceUsernames(text, usernameMap) {
// usernameMap: Map<string, number>，键为用户名（不含@），值为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 提取等真实业务场景。
