类外定义方法后代码补全失效，如何恢复参数与括号补全？

直接将函数赋值给类属性时，IDE会将其识别为普通字段而非实例方法，导致无法提供括号和参数提示。以下是两种可行的解决方案：

方案一：使用混入类（Mixin） #

将共享方法定义在一个专门的混入类中，让需要复用该方法的类继承这个混入类。这种方式符合Python面向对象的设计习惯，IDE能正确识别实例方法并提供补全。

from dataclasses import dataclass

# 定义混入类，存放共享方法
class DAPMixin:
    def get_dap(self):
        pass

@dataclass
class Country(DAPMixin):
    ctr_cc: str
    ctr_code: str
    ctr_name: str

@dataclass
class Region(Country):
    reg_code: str
    reg_name: str

dk1 = Region(ctr_cc="DK", ctr_code="DENMARK", ctr_name="Denmark", reg_code="DK1", reg_name="East Denmark")
dk1.get_dap()  # IDE会正常显示括号和self参数提示

方案二：使用类装饰器 #

通过类装饰器将共享方法动态添加到目标类中，同样能让IDE识别为实例方法。

from dataclasses import dataclass

def get_dap(self):
    pass

# 定义装饰器，给类添加共享方法
def add_dap_method(cls):
    cls.get_dap = get_dap
    return cls

@add_dap_method
@dataclass
class Country:
    ctr_cc: str
    ctr_code: str
    ctr_name: str

@add_dap_method
@dataclass
class Region(Country):
    reg_code: str
    reg_name: str

dk1 = Region(ctr_cc="DK", ctr_code="DENMARK", ctr_name="Denmark", reg_code="DK1", reg_name="East Denmark")
dk1.get_dap()  # 正常触发IDE补全

原因说明 #

直接赋值函数到类属性时，该函数在类中仅作为普通的函数对象存在，IDE无法自动推断它会被作为实例方法绑定到对象调用。而通过继承混入类或装饰器添加方法，方法会被识别为类的成员方法，IDE能正确解析其调用签名，从而提供补全支持。

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