如何让Mypy识别基于TypedDict动态生成属性的Python类？

你的核心问题是Mypy无法静态识别通过setattr动态添加的属性，因为静态检查工具无法追踪运行时的属性赋值操作。以下是几种合规的解决方案，能让Mypy正确识别类的属性类型：

方案1：显式声明类属性（最简单直接） #

直接将TypedDict中的字段作为类的属性注解声明，让Mypy静态感知这些属性的存在，同时保留动态初始化逻辑：

from typing import NotRequired, TypedDict, Unpack

class KwargsDict(TypedDict):
    integer: int
    string: NotRequired[str]

class DynamicDataClass:
    # 显式声明与TypedDict匹配的属性类型
    integer: int
    string: str | None  # NotRequired对应Optional类型

    def __init__(self, **kwargs: Unpack[KwargsDict]):
        # 可选择性添加参数验证逻辑，确保传入值符合类型要求
        for key, value in kwargs.items():
            setattr(self, key, value)

# 使用示例
klass1 = DynamicDataClass(integer=1, string="2")
klass1.integer  # Mypy无报错
klass1.string

klass2 = DynamicDataClass(integer=1)
klass2.integer
klass2.string  # Mypy识别为str | None

优点：实现简单，Mypy支持完美；缺点：TypedDict修改后需要同步更新类的属性注解，存在重复定义。

方案2：使用Protocol复用TypedDict结构 #

定义一个与TypedDict结构一致的Protocol，将实例类型标注为该Protocol，让Mypy通过协议识别属性：

from typing import NotRequired, TypedDict, Unpack, Protocol

class KwargsDict(TypedDict):
    integer: int
    string: NotRequired[str]

# 定义与TypedDict结构匹配的协议
class DynamicDataProtocol(Protocol):
    integer: int
    string: str | None

class DynamicDataClass:
    def __init__(self, **kwargs: Unpack[KwargsDict]):
        for key, value in kwargs.items():
            setattr(self, key, value)

# 使用时指定实例类型为Protocol
klass1: DynamicDataProtocol = DynamicDataClass(integer=1, string="2")
klass1.integer  # Mypy无报错
klass1.string

klass2: DynamicDataProtocol = DynamicDataClass(integer=1)
klass2.integer
klass2.string

优点：避免重复定义，Protocol可复用；缺点：实例化时需要显式标注类型，略繁琐。

方案3：泛型+TypedDict（最灵活） #

通过泛型类绑定TypedDict，结合__getattr__让Mypy支持动态属性的类型提示，适合需要适配多种TypedDict的场景：

from typing import Generic, TypeVar, NotRequired, TypedDict, Unpack, Any

# 定义绑定TypedDict的类型变量
TD = TypeVar('TD', bound=TypedDict)

class DynamicDataClass(Generic[TD]):
    def __init__(self, **kwargs: Unpack[TD]):
        for key, value in kwargs.items():
            setattr(self, key, value)

    # 提示Mypy该类可访问TD中定义的属性
    def __getattr__(self, name: str) -> Any:
        raise AttributeError(f"{self.__class__.__name__} has no attribute '{name}'")

# 定义具体的TypedDict
class KwargsDict(TypedDict):
    integer: int
    string: NotRequired[str]

# 实例化时指定泛型参数
klass1: DynamicDataClass[KwargsDict] = DynamicDataClass(integer=1, string="2")
klass1.integer  # Mypy识别该属性
klass1.string

klass2: DynamicDataClass[KwargsDict] = DynamicDataClass(integer=1)
klass2.integer
klass2.string  # Mypy识别为Optional[str]

优点：一次定义适配多种TypedDict，扩展性强；缺点：需要Mypy版本≥0.910，对泛型TypedDict的支持更完善。

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