Python中typing._GenericAlias是什么？与typing.GenericAlias有何区别？

1. typing._GenericAlias的含义 #

typing._GenericAlias是Python标准库的内部未公开类，专门用来标识typing模块导出的泛型别名（比如typing.List[int]、typing.Dict[str, int]这类旧写法的泛型类型）。因为以下划线开头，属于底层实现细节，官方文档不会收录，Python版本迭代中可能随时变更或移除，绝对不要在业务代码里直接依赖它。

2. 两者的核心区别 #

• 适用场景
  • typing._GenericAlias：对应typing模块里的泛型构造，是Python 3.9之前标注泛型的旧方案产物；
  • typing.GenericAlias：对应Python 3.9+引入的内置类型泛型写法，比如list[int]、dict[str, int]，是官方公开支持的标准泛型别名类。
• 公开状态
  • typing._GenericAlias是私有内部类，无官方兼容性保障；
  • typing.GenericAlias是公开API，属于Python官方认可的标准类型，可安全用于代码中。
• 演进逻辑
  Python 3.9推出原生类型泛型后，新增GenericAlias来统一处理原生容器的泛型标注，_GenericAlias作为旧typing模块泛型的底层实现，仅为兼容旧代码保留，后续有被逐步替换的可能。

3. 代码验证示例 #

import typing

# 旧typing模块泛型的类型
assert type(typing.List[int]) == typing._GenericAlias
# 3.9+原生类型泛型的类型
assert type(list[int]) == typing.GenericAlias

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