You need to enable JavaScript to run this app. Discord.py 开发问题:如何通过用户数字ID获取对应的User Tag?
优惠活动
大模型
产品
解决方案
定价
更多

Discord.py 开发问题:如何通过用户数字ID获取对应的User Tag?

discord.py 通过用户ID获取用户Tag的实现方法

前置配置

首先你需要在Discord开发者平台的机器人设置页开启 Server Members Intent,同时初始化bot时开启成员意图:

import discord
from discord.ext import commands

intents = discord.Intents.default()
intents.members = True # 必须开启,否则无法正常获取服务器内成员信息

bot = commands.Bot(command_prefix="!", intents=intents)

具体实现逻辑

场景1:目标用户与机器人在同一个服务器

直接调用服务器对象的get_member()方法从缓存获取成员对象,转换为字符串即可得到完整Tag:

@bot.command()
async def query_user_tag(ctx, user_id: int):
    # 从当前服务器缓存获取成员
    member = ctx.guild.get_member(user_id)
    if member:
        await ctx.send(f"用户Tag:{str(member)}")
        return

场景2:目标用户不在当前服务器

调用fetch_user()方法直接从Discord API拉取全局用户信息,该方法为协程需要加await:

# 缓存未命中时调用API拉取全局用户
    try:
        user = await bot.fetch_user(user_id)
        await ctx.send(f"用户Tag:{str(user)}")
    except discord.NotFound:
        await ctx.send("不存在对应ID的用户")

注意事项

  • 不推荐使用bot.get_user()方法,该方法仅从本地缓存读取用户信息,缓存缺失时会返回空,可靠性低于fetch_user()
  • 保持用户ID作为唯一数据主键即可,无需存储用户Tag,展示时实时拉取即可避免用户修改Tag后数据不一致
  • fetch_user()有API调用频率限制,不要高频批量调用

内容的提问来源于stack exchange,提问作者Sk0nk

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.07 17:00:03