升级Mypy至1.14.1后，传递StringIO对象给TextIOWrapper类型参数时出现类型错误的问题咨询

嗨，我来帮你一步步理清这个问题的来龙去脉，以及怎么解决它！

一、先搞懂这个错误到底说的是什么 #

你看到的错误提示：

error: Argument 1 to "_redirect_stdout" has incompatible type "StringIO"; expected "TextIOWrapper[_WrappedBuffer]" [arg-type]

简单来说，你的代码里把io.StringIO()创建的对象传给了参数标注为io.TextIOWrapper的_redirect_stdout函数，但这两个不是同一个类型，也没有继承关系——Mypy新版本现在严格检查了这种类型不匹配，而旧版本0.812没检测出来。

二、Mypy到底做了什么改变？ #

在Mypy 0.812到1.14.1的版本迭代中，开发团队对Python标准库的类型注解做了更精准的完善，尤其是io模块的类型层次：

• 之前的Mypy版本可能对TextIOWrapper的类型检查比较宽松，默认允许StringIO这类实现了文本IO接口的对象“混过”检查；
• 但实际上，StringIO和TextIOWrapper都继承自抽象基类io.TextIOBase，但它们是同级的具体类，不存在子类关系。新版本Mypy严格遵循了Python的类型层次定义，所以现在会抛出这个类型不兼容的错误。

三、几种可行的解决方法 #

方法1：把参数类型放宽到抽象基类（推荐）

既然StringIO和TextIOWrapper都实现了io.TextIOBase（或者更常用的io.TextIO，它是TextIOBase的便捷别名），我们可以把函数的参数类型标注改成这个更宽泛的抽象类型，这样两种对象都能被正常接受：

修改后的代码：

import contextlib
import sys
import io
from typing import Generator

@contextlib.contextmanager
def _redirect_stdout(
    new_target: io.TextIO  # 也可以用更底层的 io.TextIOBase
) -> Generator[io.TextIO, None, None]:
    old_target = sys.stdout
    sys.stdout = new_target

    try:
        yield new_target
    finally:
        sys.stdout = old_target


target_stdout = io.StringIO()

with _redirect_stdout(target_stdout):
    print(['These', 'are', 'sample', 'strings.'])

方法2：使用类型转换（不推荐，除非特殊场景）

如果你因为某些原因必须保留TextIOWrapper的类型标注，可以用typing.cast强行告诉Mypy这个StringIO对象是符合要求的，但这相当于绕过了类型检查，可能隐藏潜在问题：

from typing import cast

# 调用时用cast转换类型
with _redirect_stdout(cast(io.TextIOWrapper, target_stdout)):
    print(['These', 'are', 'sample', 'strings.'])

方法3：改用临时文件模拟TextIOWrapper（适合需要真实文件对象的场景）

如果你的逻辑依赖真实的TextIOWrapper特性（比如需要文件描述符），可以用tempfile模块创建临时文件来替代StringIO：

import tempfile

with tempfile.NamedTemporaryFile(mode='w+', encoding='utf-8') as temp_file:
    with _redirect_stdout(temp_file):
        print(['These', 'are', 'sample', 'strings.'])
    temp_file.seek(0)
    print(temp_file.read())

备注：内容来源于stack exchange，提问作者Sujay