如何实现带类型提示支持的Python适配器模式？

你遇到的问题本质是：仅靠__getattr__代理属性时，静态类型检查器无法识别包装类与被包装类的兼容性，也无法推断被包装类的属性。要同时实现包装逻辑和完善的类型支持，需要让类型检查器明确包装类实现了被包装类的属性接口，同时保留自身静态字段。

以下是三种实用解决方案：

方法1：显式声明被包装类的属性（适合字段较少的场景） #

直接在包装类中用@property显式定义被包装类的核心属性，搭配__getattr__做兜底处理，既满足类型提示，又保证运行时兼容性。

from dataclasses import dataclass
from typing import Any

# 被包装的数据类
@dataclass
class Component:
    id: str
    name: str
    value: int

class FieldComponent:
    def __init__(self, component: Component, field_name: str):
        self._component = component
        self.field_name = field_name  # 包装类自身的静态字段

    # 显式声明Component的核心属性，让类型检查器识别
    @property
    def id(self) -> str:
        return self._component.id

    @property
    def name(self) -> str:
        return self._component.name

    @property
    def value(self) -> int:
        return self._component.value

    # 兜底处理Component可能新增的属性（可选）
    def __getattr__(self, name: str) -> Any:
        return getattr(self._component, name)

效果：

• 类型检查器会判定FieldComponent兼容Component类型，返回时不会报类型不兼容错误
• 访问field_component.id、field_component.name等属性时会触发IntelliSense
• 自身的field_name字段也能正常获得类型提示

方法2：使用Protocol定义接口（适合字段较多或动态适配场景） #

通过Protocol定义被包装类的属性接口，让包装类实现该接口，结合__getattr__代理属性，减少重复代码的同时满足类型检查需求。

from dataclasses import dataclass
from typing import Protocol, Any, cast

# 定义Component的属性接口
class ComponentProtocol(Protocol):
    id: str
    name: str
    value: int

# 被包装的数据类实现该接口
@dataclass
class Component(ComponentProtocol):
    id: str
    name: str
    value: int

class FieldComponent:
    def __init__(self, component: ComponentProtocol, field_name: str):
        self._component = component
        self.field_name = field_name

    # 代理所有ComponentProtocol的属性
    def __getattr__(self, name: str) -> Any:
        return getattr(self._component, name)

    # 告诉类型检查器：我们实现了ComponentProtocol的属性
    @property
    def id(self) -> str:
        return cast(str, getattr(self._component, "id"))

    @property
    def name(self) -> str:
        return cast(str, getattr(self._component, "name"))

    @property
    def value(self) -> int:
        return cast(int, getattr(self._component, "value"))

效果：

• 类型检查器会将FieldComponent视为ComponentProtocol的实现，兼容所有需要该接口的场景
• 后续Component新增字段时，只需更新ComponentProtocol即可自动获得类型提示
• 自身静态字段field_name不受影响

方法3：泛型适配（支持多种被包装类场景） #

如果需要用同一个包装类适配多种类型的被包装类，可以结合Generic和TypeVar实现动态类型兼容：

from dataclasses import dataclass
from typing import Generic, TypeVar, Protocol, Any, cast

T = TypeVar('T', bound='ComponentProtocol')

class ComponentProtocol(Protocol):
    id: str
    name: str
    value: int

@dataclass
class Component(ComponentProtocol):
    id: str
    name: str
    value: int

class FieldComponent(Generic[T]):
    def __init__(self, component: T, field_name: str):
        self._component = component
        self.field_name = field_name

    def __getattr__(self, name: str) -> Any:
        return getattr(self._component, name)

    # 泛型下的属性声明
    @property
    def id(self) -> str:
        return cast(str, getattr(self._component, "id"))

    @property
    def name(self) -> str:
        return cast(str, getattr(self._component, "name"))

    @property
    def value(self) -> int:
        return cast(int, getattr(self._component, "value"))

效果：

• 可通过同一个FieldComponent包装所有符合ComponentProtocol的类
• 类型检查器会根据传入的泛型参数自动推断属性类型

注意事项 #

• 若被包装类是数据类，不要直接继承，避免字段冲突和语义混淆（包装是has-a关系，继承是is-a关系）
• 显式声明属性是让类型检查器识别的核心，仅靠__getattr__无法让静态分析工具推断属性
• 使用Pylance时，可开启strict模式验证类型兼容性

内容的提问来源于stack exchange，提问作者mario.b