给第三方实例打猴子补丁时MyPy报has no attribute错误如何解决

以下是几种满足需求的实现方式，无需子类化第三方类：

1. 基于Protocol + cast做实例类型转换 #

先定义包含新增属性的结构协议，将第三方实例转换为该协议类型，一次转换后所有后续使用该实例的位置都能正常识别新增属性，完全不影响运行时逻辑：

from typing import Protocol, cast
from external_module import ExternalClass

# 定义你需要扩展的属性结构
class PatchedObject(Protocol):
    prop: int
    # 可以继续加其他你需要新增的属性

# 对第三方实例做类型转换，仅对MyPy生效
my_object: PatchedObject = cast(PatchedObject, instance_from_external_module)

my_object.prop = 2 # 无MyPy报错
# 后续所有调用my_object.prop的位置都不会触发属性不存在错误

2. 全局扩展第三方类的类型定义 #

如果你需要该第三方类的所有实例都默认识别该新增属性，可以通过类型检查块全局扩展类的类型，运行时完全不生效：

from typing import TYPE_CHECKING

if TYPE_CHECKING:
    # 仅在MyPy执行类型检查时运行这段逻辑
    from external_module import ExternalClass
    # 给类新增属性的类型注解
    ExternalClass.prop: int

配置完成后，项目中所有ExternalClass的实例都会被MyPy默认识别带有prop属性，不需要逐个处理实例。

3. 临时单行走忽略 #

如果仅在极小范围使用该新增属性，不需要全局适配，可以直接在赋值行加忽略标记：

my_object = instance_from_external_module
my_object.prop = 2 # type: ignore[attr-defined]

注意该方式仅忽略当前行的报错，后续读取my_object.prop的位置如果触发报错需要单独加忽略标记。

4. 用setattr赋值跳过当前行检查 #

MyPy默认不校验setattr的属性存在性，直接调用该方法赋值不会触发当前行报错：

setattr(my_object, 'prop', 2)

该方式的缺点是后续读取my_object.prop的位置仍会触发报错，需要配合上述类型转换或全局扩展方案使用。

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