Python 3.10 中 | 是原生联合类型运算符,直接生成 types.UnionType,仅限类型注解中使用,不可用于运行时表达式或旧式泛型,兼容性需注意反射和第三方库支持。

Python 3.10 中 | 联合类型运算符可以直接替代 Union
是的,从 Python 3.10 开始,| 运算符原生支持类型联合,无需再导入 Union。它不是语法糖,而是语言级特性,解析时直接生成 types.UnionType 实例(注意:不是 typing.Union)。
哪些地方能用 |,哪些不能?
| 只能在类型注解上下文中使用,且左右操作数必须是有效类型(或 None 字面量)。不能在运行时表达式中求值,也不能用于构造泛型参数以外的复杂结构。
- ✅ 允许:
def f(x: int | str) -> None | bool: - ✅ 允许:
Optional[int]等价于int | None(但None必须是字面量,不能是变量) - ❌ 不允许:
if x is int | str:(运行时无效,|此处是位或) - ❌ 不允许:
List[int | str](旧式泛型不支持,应改用list[int | str]) - ❌ 不允许:
Union[int, str] | float混用——虽然语法不报错,但类型检查器(如 mypy)可能警告冗余嵌套
与 Union 并存时的兼容性和陷阱
你仍可继续用 from typing import Union,但要注意:int | str 和 Union[int, str] 在运行时是不同对象(前者是 types.UnionType,后者是 typing.Union),尽管大多数类型检查器视其等价。
Camoufox 是一个基于 Firefox 构建的开源反检测浏览器,为 Python 自动化工作流程提供强大的指纹注入和反机器人检测规避功能。它与 Playwright 集成,以提供能够绕过现代机器人检测系统的隐身浏览能力。
- 反射场景需留意:
get_origin(int | str)返回types.UnionType,而get_origin(Union[int, str])返回typing.Union - 某些老库(如早期版本的
pydanticv1)不识别|,会报TypeError: unsupported operand type(s) for |—— 升级到 pydantic v2 或显式用Union -
None写法要严格:str | None合法,但str | NoneType非法(NoneType是类型,但|只接受None字面量)
实际写法建议和常见错误
日常开发中优先用 |,更简洁;但若项目需兼容 Union 或加类型检查守卫(if TYPE_CHECKING:)。
- 函数返回多类型:
def parse(s: str) -> int | float | None:(别写成Union[int, float] | None) - 类字段注解:
value: str | bytes = b""(注意默认值类型需匹配任一分支) - 错误写法:
def f() -> int | str |(末尾多一个|→SyntaxError) - 嵌套泛型要括号:
dict[str, list[int | str]](不是dict[str, list[int] | str],后者语义完全不同)
最易忽略的是运行时反射和第三方库兼容性——写的时候很顺,跑起来才发现某个序列化工具根本不认识 | 构造的类型对象。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










