Pycord机器人Cog无法加载问题求助

核心问题分析 #

你遇到的问题有两个关键原因：

1. 加载函数未触发：用@bot.event装饰的load函数并非Pycord内置事件，代码根本没有执行，导致Cogs未加载、控制台无输出。
2. setup函数逻辑错误：await bot.add_cog(bot)是把机器人实例本身当作Cog添加，不符合Cog加载规范，即使加载函数执行也无法正确注册Cog内的命令。

修复方案 #

1. 修正Cog加载流程 #

移除错误的事件装饰器，改用启动前手动加载的方式，同时添加异常捕获方便排查问题：

import os
import discord
from discord.ext import commands
import asyncio

bot = commands.Bot(command_prefix='!', intents=discord.Intents.all())

async def load_cogs():
    for filename in os.listdir('./cogs'):
        if filename.endswith('.py'):
            try:
                await bot.load_extension(f'cogs.{filename[:-3]}')
                print(f"Loaded Cog: {filename[:-3]}")
            except Exception as e:
                print(f"Failed to load {filename[:-3]}: {str(e)}")
        elif filename == '__pycache__':
            print("Skipping pycache folder.")

async def main():
    async with bot:
        await load_cogs()
        await bot.start('你的机器人TOKEN')

if __name__ == '__main__':
    asyncio.run(main())

2. 修正Cog文件的setup函数 #

每个Cog文件必须定义继承自commands.Cog的类，然后在setup函数中添加该类的实例：

from discord.ext import commands

# 定义你的Cog类，继承自commands.Cog
class ModerationCog(commands.Cog):
    def __init__(self, bot):
        self.bot = bot

    # 示例命令
    @commands.command()
    async def kick(self, ctx, member: discord.Member):
        await member.kick()
        await ctx.send(f"已踢出成员 {member.display_name}")

# 正确的setup函数：添加Cog类的实例
async def setup(bot):
    await bot.add_cog(ModerationCog(bot))

3. 确认项目结构 #

确保你的文件结构符合要求：

项目根目录/
├── main.py
└── cogs/
    ├── moderation.py  # 你的Cog文件
    └── __pycache__/   # 自动生成的缓存文件夹，可忽略

4. 验证效果 #

启动机器人后，控制台会输出每个成功加载的Cog名称；如果加载失败，会打印具体异常信息，帮助你定位问题。

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