如何让 Discord 机器人正确显示并启用 Slash 命令

大芳吖_1734

大芳吖_1734

2026-10-08

916人浏览

原创

如何让 Discord 机器人正确显示并启用 Slash 命令

Discord 机器人的 Slash 命令不会自动显示,必须显式调用 tree.sync() 同步到服务器或全局;缺少此步骤是命令不可见的最常见原因。

discord 机器人的 slash 命令不会自动显示,必须显式调用 `tree.sync()` 同步到服务器或全局;缺少此步骤是命令不可见的最常见原因。

要使你定义的 Slash 命令(例如 /echo)在 Discord 客户端中实际出现并可被调用,关键在于命令同步(command synchronization)——这是 Discord API 的强制要求。即使代码逻辑正确、权限配置无误,若未主动触发同步,命令将始终处于“未注册”状态,用户无法看到或使用。

✅ 正确做法:在 on_ready 中同步命令

将以下代码添加到你的机器人启动完成事件中(即 @bot.event 或 @client.event 的 on_ready 回调内):

@bot.event
async def on_ready():
    print(f'Logged in as {bot.user}')
    try:
        # 同步到当前所有已加入的服务器(推荐用于开发/测试)
        await bot.tree.sync()

        # ✅ 可选:仅同步到特定服务器(需传入 Guild 对象)
        # await bot.tree.sync(guild=discord.Object(id=YOUR_GUILD_ID))

        # ✅ 可选:全局同步(生效慢,最多1小时,且需 Bot 有 APPLICATION_COMMANDS 权限)
        # await bot.tree.sync()

        print("Slash commands synced successfully.")
    except Exception as e:
        print(f"Error occurred while syncing commands: {e}")

⚠️ 注意事项:

Echo框架 5.1.0
Echo框架 5.1.0

Echo框架 5.1.0 版本源码包下载,适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。

下载
  • bot.tree.sync() 是异步操作,必须用 await 调用;
  • 同步后需手动刷新 Discord 客户端(Windows/Linux:Ctrl + R;macOS:Cmd + R),否则旧缓存可能导致命令延迟显示;
  • 若使用 guild= 参数进行本地同步(推荐开发阶段),确保 Bot 已加入该服务器,且你拥有 MANAGE_GUILD 权限(用于注册命令);
  • 全局命令同步(无 guild= 参数)对所有添加了 Bot 的服务器生效,但需 Bot OAuth2 URL 包含 applications.commands scope(你截图中已勾选 ✅,符合要求);
  • 每次修改命令名、描述或参数后,必须重新运行 sync() —— Discord 不支持热更新。

? 验证是否成功

  • 刷新 Discord 后,在任意文本频道输入 /,检查是否出现 echo 命令;
  • 若仍不显示,请确认:
    • Bot 已通过带 applications.commands scope 的链接邀请(如:https://discord.com/api/oauth2/authorize?client_id=YOUR_ID&permissions=0&scope=bot%20applications.commands);
    • 你所在的服务器已启用开发者模式,并确认 Bot 拥有 Use Application Commands 权限(通常随 Send Messages 等基础权限自动赋予);
    • 终端日志中输出 "Slash commands synced successfully.",且无报错。

完成以上步骤后,你的 /echo 命令即可正常响应交互,无需重启 Bot 即可快速迭代调试。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
DBeaver怎么导入数据
DBeaver怎么导入数据

DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。

2026.11.05

20

12

DBeaver安全防护教程大全
DBeaver安全防护教程大全

DBeaver安全防护专题,围绕数据库连接安全、账号密码保护和访问权限管理展开,整理SSL/TLS加密连接、SSH隧道、数据库凭据保存及证书验证等配置方法,同时介绍敏感信息保护、远程连接风险和高权限账号使用等注意事项,帮助用户提高数据库日常管理的安全性。

2026.11.05

20

12

DBeaver连接创建与配置教程
DBeaver连接创建与配置教程

本专题聚焦DBeaver数据库连接配置与管理,覆盖从新建连接、选择数据库类型到填写连接参数和验证连接的完整流程。针对MySQL、PostgreSQL、SQL Server等常见数据库,整理相应的连接设置方法,并提供驱动缺失、认证失败和连接异常等问题的排查方向。

2026.11.04

20

16

XORM框架结构体映射与表结构同步
XORM框架结构体映射与表结构同步

本专题围绕XORM框架的结构体映射展开,说明表名与字段的命名策略、xorm标签常用属性、主键自增与时间字段自动填充,并演示Sync2自动建表、增量字段升级、索引声明与反向生成结构体的完整流程。

2026.11.04

20

15

XORM框架安装配置与数据库连接
XORM框架安装配置与数据库连接

本专题聚焦XORM框架的配置与连接环节,拆解MySQL、PostgreSQL、SQLite、SQL Server的DSN写法与驱动选择,讲清连接池参数、多数据源拆分、读写分离与超时重连的处理方式,并补充容器与兼容数据库的适配经验。

2026.11.04

0

15

XORM框架安装配置与数据库连接
XORM框架安装配置与数据库连接

本专题聚焦XORM框架的配置与连接环节,拆解MySQL、PostgreSQL、SQLite、SQL Server的DSN写法与驱动选择,讲清连接池参数、多数据源拆分、读写分离与超时重连的处理方式,并补充容器与兼容数据库的适配经验。

2026.11.04

0

16

XORM框架安装配置与数据库连接
XORM框架安装配置与数据库连接

本专题聚焦XORM框架的配置与连接环节,拆解MySQL、PostgreSQL、SQLite、SQL Server的DSN写法与驱动选择,讲清连接池参数、多数据源拆分、读写分离与超时重连的处理方式,并补充容器与兼容数据库的适配经验。

2026.11.04

0

16

XORM框架零基础入门教程
XORM框架零基础入门教程

本专题梳理XORM框架的入门路径,从框架定位、依赖安装、连接数据库到跑通第一个增删改查示例,讲清Engine初始化、日志开启与项目目录规划,并对比GORM等同类ORM的差异,帮助Go开发者建立整体认知。

2026.11.04

0

15

Docker Desktop怎么设置端口映射
Docker Desktop怎么设置端口映射

本专题聚焦Docker Desktop容器端口映射与访问配置,整理从创建容器、设置端口绑定到验证本地服务访问的操作流程。针对端口被占用、映射配置错误、容器服务无法访问等情况,也提供相应的检查方向,方便用户完成端口配置。

2026.11.03

40

18

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Echo框架路由配置手册
Echo框架路由配置手册

共0课时 | 0人学习

Echo框架IP地址文档
Echo框架IP地址文档

共0课时 | 0人学习

Echo框架中文安装文档
Echo框架中文安装文档

共0课时 | 0人学习