如何从Python dataclass字段自动派生类__init__参数并支持IDE识别？

以下方案都能满足「单处维护参数定义、IDE正常识别参数提示」的需求，按实现成本从低到高排序：

方案1：直接复用dataclass继承（优先推荐） #

如果不介意类A本身被dataclass装饰，这是成本最低、兼容性最好的方案，不需要写任何额外工具代码：

from dataclasses import dataclass

@dataclass
class AOpts:
    foo: str
    bar: int

@dataclass(eq=False, repr=False, order=False) # 不需要dataclass默认的魔法方法就加这些参数，行为和普通类完全一致
class A(AOpts):
    def __post_init__(self):
        # 原本__init__中需要执行的初始化逻辑，全部放在这里即可
        # 访问参数直接用self.foo、self.bar
        pass

修改参数时只需要调整AOpts的字段，类A会自动同步所有参数，所有主流IDE（PyCharm、VS Code+Pylance）都能正常识别参数提示，子类透传逻辑也完全兼容。
如果需要给子类加额外参数，直接在子类定义字段即可，不需要重复声明父类参数：

@dataclass(eq=False, repr=False, order=False)
class B(A):
    new_param: bool

# 直接传参即可，不需要额外封装AOpts实例
example = B(foo="hi", bar=1, new_param=True)

方案2：自定义装饰器动态注入__init__（非dataclass场景适用） #

如果不希望业务类被dataclass装饰，可以用Python标准库提供的dataclass_transform标记（Python3.11+内置，低版本可通过typing_extensions包导入）实现自定义逻辑，IDE会按照dataclass的规则识别参数：

from dataclasses import fields, is_dataclass
from typing import Callable, Type, TypeVar
# Python版本低于3.11用下面这行导入
# from typing_extensions import dataclass_transform
from typing import dataclass_transform

T = TypeVar("T")

def inherit_init_from(opts_cls: Type):
    if not is_dataclass(opts_cls):
        raise TypeError("参数类必须是dataclass")
    opt_field_names = [f.name for f in fields(opts_cls)]
    
    def decorator(cls: Type[T]) -> Type[T]:
        original_init = cls.__init__
        def wrapped_init(self, *args, **kwargs):
            # 拆分opts参数和类自身的参数
            opt_kwargs = {name: kwargs.pop(name) for name in opt_field_names if name in kwargs}
            self._opts = opts_cls(**opt_kwargs)
            original_init(self, *args, **kwargs)
        cls.__init__ = wrapped_init
        return cls
    
    # 关键标记：告诉IDE被装饰的类__init__参数和opts_cls字段一致
    return dataclass_transform()(decorator(opts_cls))

# 使用示例
@inherit_init_from(AOpts)
class A:
    def __init__(self):
        # 不需要重复声明foo、bar参数
        # 访问参数通过self._opts.foo、self._opts.bar即可
        pass

# IDE会正常提示foo、bar参数，运行无问题
test = A(foo="hi", bar=1)

方案3：基于Pydantic实现（适合需要参数校验的场景） #

如果项目中已经在用Pydantic做参数校验，直接继承Pydantic的BaseModel即可天然支持字段复用，IDE提示也完全正常：

from pydantic import BaseModel

class AOpts(BaseModel):
    foo: str
    bar: int

class A(AOpts):
    def __init__(self, **kwargs):
        super().__init__(**kwargs)
        # 自定义初始化逻辑

注：你示例代码中的B(new_param: True, AOpts(foo="hi", bar=1))存在语法错误，new_param: True是类型注解写法，函数传参需要用等号，正确写法为B(new_param=True, a_opts=AOpts(foo="hi", bar=1))。

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