如何正确检查Python变量的类型是否为List[str]

Python的List[str]这类泛型属于静态类型注解，仅用于mypy等静态类型检查工具的分析阶段，会发生运行时类型擦除，无法直接和type()的返回值做等值判断。你代码中type(x)实际返回的是Python内置的list类，和List[str]对比永远成立，所以会误触发异常。

根据你的使用场景可以选择两种实现方式：

无第三方依赖的原生实现 #

如果你不想引入额外依赖，可以分两步做校验：

1. 先校验容器本身是list类型，这里用isinstance而不是type()等值判断，兼容list子类的场景：

if not isinstance(x, list):
    raise ValueError("x should be list of str")

2. 再校验列表内所有元素都是str类型：

if not all(isinstance(item, str) for item in x):
    raise ValueError("x should be list of str")

也可以合并为单条判断逻辑：

if not isinstance(x, list) or not all(isinstance(i, str) for i in x):
    raise ValueError("x should be list of str")

注：Python 3.9及以上版本可以直接用内置的list[str]代替typing.List[str]做类型注解，效果完全一致。

第三方库简化实现 #

如果项目中已经引入pydantic做数据校验，可以直接用TypeAdapter实现一行校验，无需手动遍历：

from pydantic import TypeAdapter
from typing import List

# 定义校验规则
list_str_validator = TypeAdapter(List[str])
# 校验不通过时会自动抛出ValidationError异常
x = list_str_validator.validate_python(x)

如果仅需要静态类型检查，不需要运行时强制校验，直接用mypy等工具扫描代码即可，不需要编写额外的运行时校验逻辑。

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