discord.py 终极入门10分钟打造你的第一个 Discord BotPython新手友好【免费下载链接】discord.pyAn API wrapper for Discord written in Python.项目地址: https://gitcode.com/gh_mirrors/di/discord.pydiscord.py 是一款用 Python 编写的 Discord API 封装库能让你快速打造自己的 Discord Bot聊天机器人。它现代、易用、功能丰富完整支持异步编程。本文作为Python 新手友好的 discord.py 教程带你从安装、配置到上线10 分钟跑通你的第一个 Bot。 discord.py 是什么discord.py 是 Discord 官方的 Python 生态中最流行的 API wrapper接口封装库核心特性包括✅ 现代 Pythonic 风格 API基于async/await异步编程✅ 自动处理 API 速率限制rate limit✅ 速度与内存双重优化性能出色✅ 内置 commands 扩展模块用装饰器几行代码定义命令更多特性说明可查阅项目根目录的 README.rst。 一键安装discord.py 最快配置方法discord.py 要求Python 3.8 或更高版本。打开终端执行以下命令即可安装# Linux / macOS python3 -m pip install -U discord.py # Windows py -3 -m pip install -U discord.py 小贴士如果还需要语音功能安装时加上voice选项pip install discord.py[voice]Linux 上还需先安装libffi-dev和python3-dev系统包。 获取 Discord Bot Token关键 3 步Token 是 Bot 登录 Discord 的身份证在 Discord 开发者后台申请即可。第 1 步创建应用并进入 Bot 页面点击 Add Bot 创建机器人页面会显示你的Token点 Reset Token 可生成新 Token。⚠️ Token 只显示一次务必复制保存好切勿泄露第 2 步进入 OAuth2 页面切换到 OAuth2 页面这里是配置 Bot 授权链接的地方第 3 步勾选 bot 作用域并生成邀请链接在Scopes区域勾选bot然后在Bot Permissions权限区按需勾选新手建议至少勾选 Send Messages发送消息和 Read Messages/View Channels读取消息/查看频道点击生成的链接把 Bot 邀请到你的服务器。⚙️ 开启特权意图Privileged Intents⚠️ 常见新手坑要让 Bot 读取消息内容必须在开发者后台的Bot页面手动打开MESSAGE CONTENT INTENT开关否则 Bot 会聋哑收不到消息⏱️ 10 分钟写出你的第一个 Discord Bot新建一个example_bot.py文件注意不要命名为discord.py会与库名冲突写入下面这段代码import discord intents discord.Intents.default() intents.message_content True client discord.Client(intentsintents) client.event async def on_ready(): print(f登录成功{client.user}) client.event async def on_message(message): if message.author client.user: return if message.content ping: await message.channel.send(pong) client.run(你的Token)逐行理解对照 docs/quickstart.rstIntents.default()message_content True声明 Bot 要监听消息内容discord.Client建立与 Discord 的连接on_readyBot 登录完成时触发打印登录账号on_message收到任何消息时触发判断是否是ping并回复pong运行python example_bot.py终端显示登录成功后去 Discord 频道输入pingBot 就会回复pong想要命令式 Bot用commands.Botbot.command()装饰器几行就能实现ping、roll 2d6这类斜杠风格命令完整示例见 examples/basic_bot.py事件模型源码在 discord/client.py。 常见问题速查问题解决办法ModuleNotFoundError: No module named discord重新执行安装命令建议先创建虚拟环境Bot 收不到消息检查 MESSAGE CONTENT INTENT 是否已开启登录报 Token 错误Token 泄露会被重置重新复制最新 Token文件导入冲突文件名避免命名为discord.py 小结与进阶路线恭喜你已经掌握了discord.py 入门的全部核心流程安装 → 获取 Token → 开启意图 → 编写第一个 Bot。接下来推荐按此路线进阶 阅读 docs/quickstart.rst 了解完整事件系统 学习 docs/ext/commands/index.rst 掌握命令、Cog 插件与帮助系统️ 尝试 examples/views/counter.py 给 Bot 加上交互按钮 研究 docs/interactions/api.rst 打造 Discord 原生斜杠命令应用现在就打开终端10 分钟后你的第一个 Discord Bot 就会上线【免费下载链接】discord.pyAn API wrapper for Discord written in Python.项目地址: https://gitcode.com/gh_mirrors/di/discord.py创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考