Python Discord Bot中@[实例].event与@[实例].command()装饰器的作用及替代实现方法咨询

先提个小细节：你代码里定义的实例是bot = commands.Bot(...)，但后面用了@client.command()，这里要改成@bot.command()哦，不然会因为找不到client实例报错～

下面详细拆解这两个装饰器的作用：

@bot.event 装饰器 #

这个装饰器是用来给机器人注册事件处理函数的。Discord机器人本质是持续监听Discord API推送的各类事件——比如机器人成功上线、收到用户消息、服务器新增成员等。

当你用@bot.event装饰函数（比如你写的on_ready()），就相当于告诉机器人：「当on_ready这个事件触发时，执行这个函数里的代码」。比如on_ready事件只会在机器人完全启动并连接到Discord后触发一次，所以你里面的打印代码会在机器人就绪时输出提示。

@bot.command() 装饰器 #

这个装饰器是用来注册用户可调用的命令的。它会把你定义的函数转换成机器人能识别的命令，配合你设置的command_prefix（这里是!），用户在频道发送!命令名就能触发对应函数。

比如你写的ping函数，加上@bot.command()后，用户发!ping，机器人就会执行这个函数，回复带延迟时间的PONG消息。装饰器还帮你做了很多底层工作：解析命令参数、处理权限、捕获错误等，不用你手动写这些逻辑。

能不能不用装饰器实现同样功能？ #

当然可以！装饰器本质是Python的语法糖，底层其实是调用机器人实例的方法来注册函数。下面是具体替代写法：

替代@bot.event：使用bot.add_listener() #

直接调用add_listener方法注册事件处理函数，效果和装饰器完全一致：

import discord
from discord.ext import commands

bot = commands.Bot(command_prefix="!", description="I'M HERE TO SERVE YOU.")

# 先定义事件函数
async def on_ready():
    print(f"BOT {bot.user.name} IS READY TO MISSION.")

# 把函数注册为on_ready事件的监听器
bot.add_listener(on_ready, "on_ready")

如果函数名和事件名完全一致（比如函数名就是on_ready），还可以省略第二个参数，直接写bot.add_listener(on_ready)。

替代@bot.command()：使用bot.add_command() #

要注册命令，需先创建commands.Command对象，再用add_command方法添加到机器人实例：

# 先定义命令函数
async def ping(ctx):
    await ctx.send(f"PONG! {round(bot.latency * 1000)}ms")

# 创建Command对象，指定命令名称和对应回调函数
ping_command = commands.Command(name="ping", callback=ping)
# 将命令添加到机器人
bot.add_command(ping_command)

也可以用更简洁的写法（这其实就是装饰器的底层实现逻辑）：

ping_command = bot.command(name="ping")(ping)

最后补充：虽然不用装饰器也能实现功能，但装饰器让代码更简洁、可读性更高，也是Discord.py官方推荐的写法，新手用装饰器会更省心，也更容易维护代码。

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