实例化后调用带参装饰器修饰的方法报parameter 'self' unfilled原因？

这个报错是PyCharm静态类型推断的局限性导致的误报，和你代码的实际运行逻辑无关，这也是你代码可以正常执行的核心原因：

• PyCharm不会实际运行代码推导装饰器的行为，只会静态扫描代码结构推断变量、方法的类型。你使用了三层嵌套的带参装饰器，没有额外的类型注解时，PyCharm无法识别到被装饰后的do方法仍然是类的实例方法，误将其判定为普通顶层函数，因此抛出了需要手动传入self参数的错误提示。
• Python解释器实际执行代码时，被装饰后的wrapped_f会被正常识别为类的实例方法，调用b.do()时会自动把实例b绑定到第一个self参数，因此代码运行不会出现任何问题。

如果要消除IDE的误报，可以选择以下任意一种方案：

方案1：给装饰器补充类型注解 #

通过类型标注明确告诉PyCharm装饰器的返回值和被装饰的原方法类型一致，IDE就可以正确识别实例方法的特征：

from typing import Callable, TypeVar, Any

# 定义类型变量
T = TypeVar('T')
F = TypeVar('F', bound=Callable[..., Any])

def incrementor(track_bool: bool) -> Callable[[F], F]:
    def wrapper(f: F) -> F:
        def wrapped_f(self: T, *args, **kwargs):
            if track_bool:
                self.x += 1
                print('increment')
            return f(self, *args, **kwargs)
        # 告诉类型检查器忽略此处的类型不匹配，我们人为保证返回的方法和原方法签名兼容
        return wrapped_f # type: ignore
    return wrapper

方案2：局部忽略IDE检查 #

在报错的调用行前加注释，让PyCharm跳过当前行的参数检查：

# noinspection PyArgumentList
b.do()  # 调用装饰后的方法

方案3：使用functools.wraps标注 #

在装饰器内部的wrapped_f上添加@functools.wraps(f)注解，保留原方法的元信息，也可以降低IDE误判的概率：

import functools

def incrementor(track_bool):
    def wrapper(f):
        @functools.wraps(f)
        def wrapped_f(self, *args, **kwargs):
            if track_bool:
                self.x += 1
                print('increment')
            return f(self, *args, **kwargs)
        return wrapped_f
    return wrapper

现有代码的运行逻辑完全正确，该误报不会影响代码执行，也不会在和其他业务逻辑联动时引发故障，无需担心运行时的兼容性问题。

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