根据PEP 484，在现代版本的 Python 中，可以使用函数注释进行静态类型分析。这可以通过打字模块轻松完成。
现在我想知道如何为“文件流”提供“类型提示”。
def myfunction(file: FILETYPE):
pass
with open(fname) as file:
myfunction(file)
我将插入什么作为FILETYPE？
使用print(type(file)) 会返回<class '_io.TextIOWrapper'>，这根本不清楚。
没有通用的“文件”类型吗？
【问题讨论】：
StringIO？
标签： python python-3.5 type-hinting
您可以使用typing.IO、typing.TextIO 和typing.BinaryIO 来表示不同类型的 I/O 流。引用documentation：
类打字.IO
类打字.TextIO
类打字.BinaryIO泛型类型
IO[AnyStr]及其子类TextIO(IO[str])和BinaryIO(IO[bytes])代表I/O流的类型，例如 由open()返回。
【讨论】：
typing.IO、typing.TextIO 和 typing.BinaryIO 自 3.8 版以来已弃用，每次键入 documentation 时将在 3.12 版中删除。
typing.io 的替代品（io.IOBase 和它的孩子）。
typing.io 命名空间 已弃用并将被删除。这些类型应直接从 typing 而是。"
【讨论】：
_io._base 和 io.base 都没有“通用”顶层？
io.IOBase 是对“字节流”的最佳类型提示，并且可以使用标准库创建的每个类似文件的对象都是它的一个实例。如果IOBase 与您对字节流的想法不符，或者您的用例不是一个好的类型提示，您可能需要编辑您的问题并解释原因。
_BufferedIOBase，它源自_IOBase
io.BytesIO 也继承自 io.IOBase。
要么：
from typing import TextIO # or IO or BinaryIO
def myfunction(file: TextIO ):
pass
或这个
from typing import TYPE_CHECKING
if TYPE_CHECKING:
from typing import TextIO # or IO or BinaryIO
def myfunction(file: 'TextIO'):
pass
第二种方法将避免在执行期间导入类。尽管 python 在执行期间仍然必须导入 TYPE_CHECKING，但最好避免导入仅用于类型提示的类：(1) 不执行（只是解析），以及 (2) 它可以避免循环导入。
【讨论】：
typeshed 有一个SupportsRead 协议：
from __future__ import annotations
from typing import TYPE_CHECKING, AnyStr
if TYPE_CHECKING:
from _typeshed import SupportsRead
def takes_readable_str(fo: SupportsRead[str]):
return fo.read()
def takes_readable_bytes(fo: SupportsRead[bytes]):
return fo.read()
def takes_readable_any(fo: SupportsRead[AnyStr]):
return fo.read()
【讨论】：
_typeshed。该模块不是仅适用于类型检查器工具的开发人员吗？
if TYPE_CHECKING.