MyPy对mutagen.id3.PictureType误报类型不兼容错误

问题原因 #

Mutagen的id3.PictureType并非标准Python enum.Enum实现，而是通过继承int的自定义类+类属性赋值的方式模拟枚举。这种实现在运行时完全合法（成员确实是PictureType实例，同时也是int的子类），但MyPy的静态类型检查逻辑无法识别这类自定义枚举的成员类型，会默认将id3.PictureType.ARTIST这类成员推断为int类型，从而和你声明的arg2: id3.PictureType类型产生冲突。

无需重写为标准Enum的解决办法 #

1. 使用类型断言（cast）强制指定类型 #

通过typing.cast明确告诉MyPy默认参数的实际类型，这是最稳妥的方案：

from mutagen import id3
from typing import cast

def fun(arg1: str, arg2: id3.PictureType = cast(id3.PictureType, id3.PictureType.ARTIST)):
    # 函数体逻辑

2. 针对性忽略MyPy错误 #

如果不想引入cast，可以在参数行添加类型忽略注释，仅屏蔽该赋值的类型错误（避免全局忽略）：

from mutagen import id3

def fun(arg1: str, arg2: id3.PictureType = id3.PictureType.ARTIST):  # type: ignore[assignment]
    # 函数体逻辑

注意：这种方式会跳过该位置的类型检查，若后续代码有相关类型问题可能无法被检测到，谨慎使用。

3. 自定义类型别名（可选） #

如果需要多次使用PictureType，可以先定义一个类型别名，再结合cast使用，提升代码可读性：

from mutagen import id3
from typing import cast, TypeAlias

PictureType: TypeAlias = id3.PictureType

def fun(arg1: str, arg2: PictureType = cast(PictureType, id3.PictureType.ARTIST)):
    # 函数体逻辑

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