discord.py使用cogs开发机器人时全局变量未定义报错如何解决

问题根因 #

• 你定义的bruh变量位于Cog类内部作用域，不属于Python模块顶层的全局作用域，方法内的global bruh声明无法匹配到对应变量，因此触发Pylance的未定义变量报错
• anti_add命令方法中没有添加global bruh声明就直接修改bruh的值，实际运行时Python会将其识别为局部变量，即使解决了定义问题也会出现赋值报错

推荐解决方案（更符合Cog开发规范） #

推荐直接用Cog实例属性替代全局变量，彻底规避作用域问题，代码可读性和可维护性更高：

class AntiAdCog(commands.Cog):
    def __init__(self, bot):
        self.bot = bot
        # 在初始化方法中定义开关属性，用布尔值比字符串判断效率更高
        self.anti_ad_enabled = False

    @commands.Cog.listener()
    async def on_message(self, message):
        if "discord.gg" in message.content.lower():
            if self.anti_ad_enabled:
                await message.delete()
                await message.channel.send("Don't advertise your server!")

    @commands.command()
    async def anti_ad(self, ctx): # 顺带修正了命令名的拼写错误anti_add→anti_ad
        self.anti_ad_enabled = not self.anti_ad_enabled
        status = "Enabled" if self.anti_ad_enabled else "Disabled"
        await ctx.send(f"Ads Detector has been {status}.")
        return self.anti_ad_enabled

兼容全局变量的修改方案 #

如果你坚持要使用全局变量实现，需要调整两个地方：

1. 将bruh = 'off'移动到模块最顶层，也就是Cog类定义的外部
2. 在anti_add方法中也添加global bruh声明

# 移到模块顶层，Cog类定义的外面
bruh = 'off'

class AntiAdCog(commands.Cog):
    def __init__(self, bot):
        self.bot = bot

    @commands.Cog.listener()
    async def on_message(self, message):
        global bruh
        if "discord.gg" in message.content.lower():
            if bruh == 'on':
                await message.delete()
                await message.channel.send("Don't advertise your server!")

    @commands.command()
    async def anti_add(self, ctx):
        global bruh # 新增global声明
        if bruh == 'off':
            bruh = 'on'
            await ctx.send('Ads Detector has been Enabled.')
            return bruh
        else:
            bruh = 'off'
            await ctx.send('Ads Detector has been Disabled.')
            return bruh

以上两种方案都可以解决Pylance的未定义变量报错，优先推荐第一种实现方式。

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