使用装饰器后PyCharm误报类方法缺少self参数的解决办法

核心解决方案：使用functools.wraps保留原方法元信息 #

最标准且有效的解决方式是借助Python标准库的functools.wraps装饰器，它会将原类方法的元信息（包括参数签名、方法名称、文档字符串等）复制到装饰器的wrapper函数上，让PyCharm的静态检查器能正确识别这是一个绑定到类实例的方法。

修改后的装饰器代码：

import functools

def add_exclamation(method):
    @functools.wraps(method)
    def wrapper(self, *method_args, **method_kwargs):
        method_output = method(self, *method_args, **method_kwargs)
        return method_output + "!"

    return wrapper

将这个装饰器应用到API.greet方法后，PyCharm就能正确解析self.greet(word="World")的调用，不会再报缺少self参数的错误。

其他临时方案（不推荐） #

如果只是临时屏蔽警告，可以在调用代码上方添加PyCharm的专属注释：

def hello_world(self):
    # noinspection PyArgumentList
    return self.greet(word="World")

但这种方式只是隐藏了警告，并没有从根本上让IDE识别方法的正确签名，不建议长期使用。

问题原因 #

原装饰器返回的wrapper函数没有继承原类方法的元信息，PyCharm的静态检查器无法判断它是一个绑定到实例的方法，误将wrapper当成普通函数，因此认为调用时需要显式传入self参数。

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