discord-js 如何正确获取3个用户提及？解决第二个用户返回undefined问题

原代码核心问题 #

• 类型不匹配导致匹配失效：message.mentions.users 存储的是Discord用户实例对象，args[1]是纯字符串格式的消息拆分内容，二者直接做相等比较永远返回false，完全无法匹配到目标用户，这就是user2持续返回undefined的直接原因。
• 取数逻辑不稳定：直接调用集合自带的first()/last()方法取用户，既无法严格对齐用户输入时的@顺序，还可能把消息中提到的机器人、角色等非目标内容算进提及结果，出现取错用户的问题。
• 渲染格式错误：直接在模板字符串中拼接用户实例，在Embed描述区无法稳定渲染成可点击的@效果，多数情况会显示为纯文本用户名而非@提及。

正确实现逻辑 #

• 把提及用户集合转换为保留输入顺序的数组，避免集合内置排序带来的取数偏差
• 增加前置校验，判断用户实际提及的有效用户数量是否达到3个，数量不足时直接返回提示，避免数组取数越界
• 按下标从数组中精准取前3个用户，和用户输入@的顺序一一对应
• 用Discord标准提及格式<@用户ID>拼接Embed内容，保证@效果正常渲染

修正后完整可运行代码 #

// 将提及用户集合转为按消息输入顺序排列的数组
const mentionedUsers = [...message.mentions.users.values()];

// 前置校验：有效提及不足3个时直接提示返回
if (mentionedUsers.length < 3) {
  return message.reply("请依次@3个目标用户后再使用本指令");
}

// 按下标精准获取3个目标用户
const user1 = mentionedUsers[0];
const user2 = mentionedUsers[1];
const user3 = mentionedUsers[2];

const embed = new Discord.MessageEmbed()
  .setColor("GREEN")
  // 用标准提及格式拼接，确保Embed内的@可点击、正常渲染
  .setDescription(`<@${user1.id}> - <@${user2.id}> <@${user3.id}>`);

message.channel.send(embed);

常见避坑提示 #

• 不要直接拿拆分后的args元素和用户ID做匹配：args数组中的提及元素带<@!用户ID>的格式标记，和纯数字的用户ID字符串不一致，直接比较也会出现匹配失败
• 不要依赖mentions集合的内置方法取序：Discord的mentions集合不是严格按照用户输入顺序排序的，转数组按下标取是最稳定的实现方式
• 如果坚持使用find方法匹配用户，必须先从args的提及字符串中提取纯数字用户ID，和用户实例的id属性做比较，直接用对象和字符串比较是完全无效的
• 需在Client初始化时配置allowedMentions参数，避免@被系统自动过滤成纯文本

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