Discord.js实现用户资料Embed中显示用户角色是否可行？

开发者阿泽

2026-5-19

当然可以实现！在Discord的Embed消息里搭建小型用户资料界面、展示用户角色是非常常见的需求，我来给你梳理下具体的实现思路和操作方法：

实现核心思路与步骤

不管你使用的是Discord.js、Pycord还是其他Discord开发库，核心逻辑都是获取用户角色数据，再将这些数据整合到Embed的结构中。

1. 先获取目标用户的角色信息

首先你需要拿到目标用户的角色列表，通常我们会过滤掉默认的@everyone角色（一般不需要展示它）。以Discord.js为例，代码示例如下：

// 获取提及的用户，默认取发送消息的用户
const targetMember = message.mentions.members.first() || message.member;
// 过滤默认角色并按权限排序（高权限角色在前）
const userRoles = targetMember.roles.cache
  .filter(role => role.name !== '@everyone')
  .sort((a, b) => b.position - a.position);

2. 构建Embed并插入角色内容

接下来把角色数据嵌入到Embed里，你可以用fields字段专门展示角色，也可以在描述区列出。还是以Discord.js为例：

const profileEmbed = new Discord.EmbedBuilder()
  .setTitle(`${targetMember.user.username}的个人资料`)
  .setThumbnail(targetMember.user.displayAvatarURL()) // 设置用户头像作为缩略图
  .addFields(
    { name: '当前昵称', value: targetMember.displayName, inline: true },
    { name: '加入服务器时间', value: targetMember.joinedAt.toLocaleDateString(), inline: true },
    { name: '拥有的角色', value: userRoles.size > 0 ? userRoles.map(role => `<@&${role.id}>`).join(', ') : '无特殊角色' }
  )
  .setColor(userRoles.first()?.color || '#0099ff'); // 优先用用户最高权限角色的颜色，默认蓝色

// 发送Embed消息
message.channel.send({ embeds: [profileEmbed] });