如何让mypy忽略Pydantic类中带特定注解的初始化参数？

方法一：将忽略字段标记为ClassVar（推荐） #

Mypy静态分析时会把ClassVar类型的字段识别为类级变量，不会要求实例化时传入参数。你可以在__init_subclass__中动态将带有特定注解的字段改为ClassVar类型，同时保留原类型提示：

from typing import Annotated, ClassVar, get_type_hints
from pydantic import BaseModel

class IgnorableBaseModel(BaseModel):
    def __init_subclass__(cls, **kwargs):
        super().__init_subclass__(**kwargs)
        type_hints = get_type_hints(cls, include_extras=True)
        for field_name, field_type in type_hints.items():
            # 检查字段是否带有目标注解
            if (
                isinstance(field_type, Annotated)
                and 'ignore me' in field_type.metadata
            ):
                # 将字段类型改为ClassVar，保留原类型
                cls.__annotations__[field_name] = ClassVar[field_type.__origin__]
                # 从Pydantic模型字段中移除该字段
                if field_name in cls.model_fields:
                    del cls.model_fields[field_name]

# 示例使用
class MyClass(IgnorableBaseModel):
    name: Annotated[str, 'ignore me']
    age: int

# 实例化时无需传入name，Mypy不会报错
obj = MyClass(age=20)
# 通过__getattr__访问name
print(obj.name)

这样处理后，Mypy会认为name是类变量，不会强制要求实例化时传入，同时你依然能保留str的类型提示，配合__getattr__实现动态属性访问。

方法二：自定义Mypy插件（复杂场景） #

如果你的DSL有大量动态字段需要处理，可以编写Mypy插件来识别自定义注解并忽略对应的参数要求。插件需要实现Plugin接口，在类型检查时过滤掉带有'ignore me'注解的字段。

核心思路是在插件的get_class_signature_hook中修改类的__init__签名，移除目标字段对应的参数。这种方法需要对Mypy插件开发有一定了解，适合大规模场景。

补充说明 #

• 如果你需要让__getattr__的返回值有精确类型提示，可以结合@overload装饰器为每个忽略字段指定返回类型。
• 避免直接使用# type: ignore[call-arg]，虽然能快速解决报错，但会丢失类型检查的严谨性，不适合长期维护的DSL项目。

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