如何编写兼容PyYAML版本且能被Mypy识别异常处理的代码？

我懂你要解决的核心痛点——不是简单忽略报错，而是要让Mypy这类类型检查器能清晰识别你对版本差异场景的处理逻辑，就像你用分支判断处理Optional[int]返回值那样。针对PyYAML的YAMLLoadWarning在不同版本中存在与否的问题，我们可以用更明确的类型友好写法来解决。

最优写法：用hasattr做前置检查 #

直接通过属性存在性判断替代try-except，让Mypy能明确感知分支逻辑：

import yaml
from warnings import filterwarnings

# 先检查属性是否存在，类型检查器能识别此分支下属性有效
if hasattr(yaml, "YAMLLoadWarning"):
    filterwarnings("ignore", category=yaml.YAMLLoadWarning)

为什么这个写法更好？

• 相比try-except，它更直接地表达了“仅当属性存在时执行操作”的意图，Mypy会通过hasattr的判断确定进入分支时yaml.YAMLLoadWarning是存在的，不会再抛出“module has no attribute”的类型错误
• 避免了原代码中except捕获所有AttributeError的宽泛性，只处理我们关心的属性缺失场景

关于try-except场景的类型适配补充 #

你提到的用try-except处理Optional[str]的例子，Mypy报错是因为它无法确定try块内的a一定非None。如果确实需要用try-except处理这类场景，可以通过typing.cast给类型检查器明确的断言：

from typing import cast, Optional

def exception_branch(a: Optional[str]) -> list:
    try:
        # 告诉Mypy：这里的a可以被视为str类型
        return cast(str, a).split()
    except AttributeError:
        return []

不过回到你的PyYAML场景，hasattr的方式是最贴合需求的——既完美适配了不同版本的属性差异，又不需要额外的类型断言就能让Mypy完全理解你的代码逻辑。

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