如何通过Python Discord Bot为服务器创建分类及文本频道？

我在PyCharm中开发Python Discord Bot，需求是实现「!Create {分类名称}」命令：用户输入该命令后，Bot创建指定名称的分类，并从textChannelNames字符串列表中生成对应文本频道，全部归入该分类。但调试时发现addcategory函数完全未执行，分类和频道都没有创建。

原代码 #

def run_discord_bot():
    TOKEN = "my discord token"
    intents = discord.Intents.default()
    intents.message_content = True
    client = discord.Client(intents=intents)
    @commands.command("!Create")
    async def addcategory(ctx):
        try:
            await ctx.guild.create_category(categoryName)
            await ctx.send(f"A new category called '{categoryName}' was made")
            for textChannel in textChannelNames:
                addTextChannel(ctx, textChannel)
        except Exception as e:
            print(e)
    async def addTextChannel(ctx, channel_name):
        try:
            guild = ctx.guild
            if ctx.author.guild_permissions.manage_channels:
                await guild.create_text_channel(name='{}'.format(channel_name))
        except Exception as e:
            print(e)
    client.run(TOKEN)

原代码问题分析 #

• 错误混用客户端类型：commands.command装饰器需要配合commands.Bot实例使用，单独用discord.Client无法识别命令，导致addcategory函数不会被触发。
• 命令定义格式错误：@commands.command("!Create")写法有误，命令名不需要带前缀，且未绑定到Bot实例，无法被识别为可触发的命令。
• 缺少命令参数：addcategory未接收categoryName参数，无法获取用户输入的分类名称。
• 异步函数调用遗漏await：调用addTextChannel时未加await，异步函数无法正确执行。
• 频道未关联分类：创建文本频道时未指定所属分类，导致频道不会归入新建分类。
• 权限检查逻辑不合理：权限检查放在每个频道创建步骤中，重复检查且无法提前拦截无权限操作。

修复后的代码 #

def run_discord_bot():
    TOKEN = "my discord token"
    intents = discord.Intents.default()
    intents.message_content = True
    # 使用commands.Bot替代discord.Client，专门处理命令
    bot = commands.Bot(command_prefix='!', intents=intents)
    @bot.command(name='create')
    async def addcategory(ctx, categoryName):
        try:
            # 提前检查用户权限，避免无效操作
            if not ctx.author.guild_permissions.manage_channels:
                await ctx.send("你没有管理频道的权限")
                return
            # 创建指定名称的分类
            newCategory = await ctx.guild.create_category(categoryName)
            await ctx.send(f"已成功创建分类: '{categoryName}'")
            # 遍历列表创建文本频道，并关联到新建分类
            for textChannel in textChannelNames:
                await addTextChannel(ctx, textChannel, newCategory)
        except Exception as e:
            print(f"创建过程出错: {e}")
            await ctx.send(f"创建失败: {str(e)}")
    async def addTextChannel(ctx, channel_name, category):
        guild = ctx.guild
        try:
            await guild.create_text_channel(name=channel_name, category=category)
        except Exception as e:
            print(f"创建频道「{channel_name}」失败: {e}")
    bot.run(TOKEN)

核心修复点 #

• 替换客户端类型：使用commands.Bot替代discord.Client，确保命令装饰器能被正确识别。
• 规范命令定义：用@bot.command(name='create')绑定命令，前缀由command_prefix='!'统一配置，命令名无需带前缀。
• 添加参数接收：addcategory函数新增categoryName参数，获取用户输入的分类名称。
• 异步调用修正：调用addTextChannel时添加await，保证异步函数正常执行。
• 关联分类与频道：创建文本频道时指定category=newCategory，让频道自动归入目标分类。
• 优化权限逻辑：将权限检查移到命令入口，提前判断用户权限并给出反馈。
• 增加错误反馈：给用户发送操作结果，同时在控制台输出错误信息，方便调试。

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