python 3.9+ 中 pytest 不解析类型提示，但测试中误用 typing 模块（如 list[str]）会导致运行时错误；应改用原生语法 list[str]，并避免用 isinstance 检查泛型类型。
Python 3.9+ 中 pytest 本身不解析类型提示，但类型提示与 pytest 共存时容易因误用 typing 模块引发运行时错误或测试失败——关键不在 pytest，而在你如何写类型注解。
pytest 不校验类型，但你的测试代码会执行类型相关的逻辑
pytest 只负责运行测试函数、捕获断言和异常。它完全不关心 def func(x: list[str]) -> dict[int, float]: 这类注解。但如果你在测试中主动调用 isinstance()、用 typing.get_origin() 解析注解，或依赖第三方库（如 pydantic、dataclasses）做运行时类型检查，那这些逻辑就会真实执行——而 Python 3.9+ 的类型语法变更会让旧写法直接报错。
- 错误现象：
NameError: name 'List' is not defined或TypeError: 'ForwardRef' object is not subscriptable - 典型场景：测试函数里写了
from typing import List; assert isinstance(data, List[str])——这在 Python 3.9+ 已失效 - 根本原因：Python 3.9 开始，
List、Dict等不再是运行时可用的类型，只是静态分析符号；只有list[str]、dict[int, float]是合法的运行时表达式
测试中需要运行时类型检查时，必须用 Python 3.9+ 原生容器语法
如果你的测试逻辑依赖类型对象（比如验证某个函数返回值是否为 list[str]），就不能再从 typing 导入大写类型，而必须用内置容器本身加方括号。
- ✅ 正确（Python 3.9+）：
assert isinstance(result, list[str])、if get_origin(type_hint) is list: - ❌ 错误（Python 3.9+）：
from typing import List; assert isinstance(result, List[str]) - ⚠️ 注意：
get_origin()和get_args()仍需从typing导入，但参数必须是原生语法构造的类型，例如get_origin(list[str])才有效，get_origin(List[str])会抛NameError - 兼容旧版本？别硬兼容。测试环境统一用 Python 3.9+，就直接用
list[str]；若真要支持 3.8-，则整个项目保持from typing import List风格，并禁用 PEP 585 提示（如 mypy 的--no-implicit-reexport）
pytest 插件如 pytest-mypy 或 pytest-pyright 会暴露类型问题
单纯跑 pytest 不会报类型错误，但如果你在 CI 或本地启用了静态类型检查插件，它们会在测试执行前扫描代码——这时 Python 3.9+ 的语法差异就会立刻暴露。
- 常见错误：
error: "List" is not defined（mypy 报错）、Cannot access member "str" for type "Type[List]"（pyright） - 解决方案：确保
pyproject.toml中 mypy 配置包含python_version = "3.9"，否则它默认按 3.8 解析，把list[str]当非法语法 - 插件安装示例：
pip install pytest-mypy，然后运行pytest --mypy；注意该命令会先做类型检查，再跑测试，失败则整个 pytest 退出 - 性能影响：每次测试都触发 mypy 扫描较慢，建议只在 CI 阶段启用，开发时用 IDE 实时提示替代
最易被忽略的一点：类型提示不是运行时契约，但很多测试会假装它是——比如用 isinstance(x, dict[str]) 断言结构，这在 Python 3.9+ 虽然语法合法，却**永远返回 False**，因为 dict[str] 是泛型类型对象，不是 dict 的子类。真要验证内容，得用 isinstance(x, dict) and all(isinstance(k, str) for k in x) 这类手动检查。类型提示在这里只是文档，别让它误导你的测试逻辑。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
