如何用discord.py实现新成员加入时在指定频道@该成员的功能

前置配置（必须完成，否则事件不触发） #

Discord 要求显式开启特权网关意图才能接收成员相关事件：

• 打开Discord开发者平台的机器人管理页，进入「Bot」标签，在「Privileged Gateway Intents」区域开启Server Members Intent
• 初始化客户端时声明成员意图，代码如下：

import discord

intents = discord.Intents.default()
intents.members = True
# 如果你用commands.Bot就替换为对应初始化代码
client = discord.Client(intents=intents)

完整on_member_join事件代码 #

@client.event
async def on_member_join(member):
    # 替换为你要发送消息的目标频道ID，可通过Discord开发者模式右键频道复制
    TARGET_CHANNEL_ID = 111111111111111111
    welcome_channel = client.get_channel(TARGET_CHANNEL_ID)
    
    # 频道存在才发消息，避免ID填错导致报错
    if welcome_channel:
        # member.mention 就是@该成员的语法，可自行修改欢迎话术
        await welcome_channel.send(f"🎉 欢迎新成员 {member.mention} 加入服务器！")

常见问题排查 #

• 确认机器人已经加入目标服务器，且拥有目标频道的「发送消息」、「提及成员」权限
• 频道ID是整数类型，不要包裹引号
• 如使用discord.py 2.x版本，必须按上文配置intents.members = True

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