Discord Bot类中使用commands.command后如何访问类成员及优化内部状态？

1. 访问类属性/方法的解决方案 #

你的问题核心是命令方法未绑定到Bot实例，导致无法通过self访问属性。有两种直接解决方式：

方式1：修正命令方法签名（推荐） #

在命令方法中添加self作为第一个参数，Discord.py会自动将实例绑定到方法，直接通过self访问实例属性和方法：

import discord
from discord.ext import commands

with open('TOKEN', 'r') as f:
    TOKEN = f.read()

class mybot(commands.Bot):
    def __init__(self):
        intents = discord.Intents.default()
        super().__init__(command_prefix="!", intents=intents)
        # 无需手动调用add_command，@commands.command装饰器会自动注册命令
        self.an_instance_property = []

    # 修正为实例方法，第一个参数用self
    def a_class_method(self, x):
        return x

    @commands.command(name='test')
    # 添加self作为第一个参数，ctx为第二个参数
    async def test(self, ctx, *args):
        # 直接访问实例属性
        self.an_instance_property.append("test entry")
        # 调用实例方法
        method_result = self.a_class_method("hello")
        await ctx.send(f"属性内容: {self.an_instance_property}\n方法返回值: {method_result}")

bot = mybot()
bot.run(TOKEN)

方式2：通过ctx.bot获取实例 #

若暂时不想修改方法签名，可通过上下文对象ctx的bot属性获取当前Bot实例，进而访问属性和方法：

@commands.command(name='test')
async def test(ctx, *args):
    bot_instance = ctx.bot
    # 访问实例属性
    bot_instance.an_instance_property.append("test entry")
    # 调用实例方法
    method_result = bot_instance.a_class_method("hello")
    await ctx.send(f"属性内容: {bot_instance.an_instance_property}\n方法返回值: {method_result}")

注意：此方式仍需将a_class_method修正为实例方法（第一个参数为self）。

2. 带内部状态Bot的更优实现思路 #

根据Bot规模，推荐两种主流方案：

方案1：继承commands.Bot类（小型Bot） #

延续你当前的思路，将所有状态和命令集中在Bot子类中：

• 优势：结构简单，状态管理集中，适合功能单一的小型Bot
• 注意：命令方法必须包含self作为第一个参数，装饰器会自动完成命令注册，无需手动调用add_command

方案2：使用Cogs模块化管理（中大型Bot） #

当Bot功能较多时，使用**Cogs（命令组）**将不同功能的命令和状态分离到独立类中，保持代码结构清晰：

import discord
from discord.ext import commands

with open('TOKEN', 'r') as f:
    TOKEN = f.read()

# 定义Cog类，维护自身的状态和命令
class MyFeatureCog(commands.Cog):
    def __init__(self, bot):
        self.bot = bot
        self.cog_specific_state = []  # Cog专属状态

    @commands.command(name='cog_test')
    async def cog_test(self, ctx, *args):
        self.cog_specific_state.append("cog test entry")
        await ctx.send(f"Cog专属状态: {self.cog_specific_state}")

# 主Bot类，管理全局状态和加载Cogs
class mybot(commands.Bot):
    def __init__(self):
        intents = discord.Intents.default()
        super().__init__(command_prefix="!", intents=intents)
        self.global_state = []  # 全局状态

    # 使用setup_hook异步加载Cogs
    async def setup_hook(self):
        await self.add_cog(MyFeatureCog(self))

bot = mybot()
bot.run(TOKEN)

• 优势：模块化程度高，不同功能的状态和逻辑隔离，便于维护和扩展
• 注意：Cog需要通过setup_hook异步添加，或在Bot启动后手动添加

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