Discord.py 快速入门指南：构建你的第一个机器人

滑茵珠Gerret

于 2025-06-02 09:15:43 发布

阅读量238

点赞数 4

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_01001/article/details/148377416

Discord.py 快速入门指南：构建你的第一个机器人

discord.py An API wrapper for Discord written in Python. 项目地址: https://gitcode.com/gh_mirrors/di/discord.py

前言

Discord.py 是一个功能强大的 Python 库，用于与 Discord API 交互并创建 Discord 机器人。本文将带你快速了解如何使用这个库创建一个简单的机器人，并解释其中的关键概念。

准备工作

在开始之前，请确保你已经：

安装了 Python 3.5.3 或更高版本
通过 pip 安装了 discord.py 库
在 Discord 开发者门户创建了一个机器人应用并获取了令牌

基础机器人示例

让我们从一个最简单的机器人开始，它会在收到特定消息时做出响应：

# 此示例需要启用 'message_content' 意图
import discord

# 设置默认意图并启用消息内容意图
intents = discord.Intents.default()
intents.message_content = True

# 创建客户端实例
client = discord.Client(intents=intents)

@client.event
async def on_ready():
    print(f'机器人已登录为 {client.user}')

@client.event
async def on_message(message):
    # 忽略机器人自己发送的消息
    if message.author == client.user:
        return
    
    # 如果消息以 $hello 开头，回复 Hello!
    if message.content.startswith('$hello'):
        await message.channel.send('Hello!')

# 使用你的令牌运行机器人
client.run('your_token_here')

代码解析

让我们逐部分理解这段代码的工作原理：

1. 导入与意图设置

首先我们导入 discord 模块，然后设置意图(intents)。意图是 Discord 引入的一种机制，用于控制机器人可以接收哪些类型的事件。在这里我们启用了默认意图，并额外启用了消息内容意图，这样机器人才能读取消息内容。

2. 客户端实例

discord.Client 是与 Discord 连接的主要接口。我们创建了一个客户端实例并传入配置好的意图。

3. 事件处理

Discord.py 使用异步事件驱动的架构。我们通过装饰器 @client.event 来注册事件处理器：

on_ready(): 当机器人成功登录并准备好接收事件时触发
on_message(message): 每当机器人接收到新消息时触发

4. 消息处理逻辑

在 on_message 处理器中，我们首先检查消息是否来自机器人自身，避免循环响应。然后检查消息内容是否以 $hello 开头，如果是，则在同一个频道发送回复。

5. 运行机器人

最后，我们调用 client.run() 方法并传入机器人的令牌来启动连接。

运行机器人

将上述代码保存为 bot.py（注意不要命名为 discord.py，这会与库名冲突），然后运行：

在 Windows 上：

py -3 bot.py

在其他系统上：

python3 bot.py

进阶说明

异步编程：Discord.py 使用 asyncio 进行异步编程，所有事件处理器都需要声明为 async 函数，调用 API 方法需要使用 await。
消息对象：message 对象包含丰富的信息，如作者、内容、频道、服务器等，你可以通过这些属性实现更复杂的功能。
命令处理：虽然这个示例使用简单的字符串检查来处理命令，但 Discord.py 提供了更强大的命令框架（ext.commands），可以更方便地构建复杂的命令系统。

常见问题

为什么机器人看不到消息内容？
- 确保已启用消息内容意图（intents.message_content = True）
- 在 Discord 开发者门户的机器人设置中也需启用此意图
如何处理错误？
- 可以添加 on_error 事件处理器来捕获和处理异常
机器人没有响应？
- 检查令牌是否正确
- 确认机器人已被邀请到服务器
- 检查是否有权限发送消息