Python多版本共存时，typing注解需用字符串字面量（如"list[int]"）并配合typing模块兜底，pydantic v2默认严格校验、需显式配置extra和alias，async函数调用必须显式await，python_requires控制安装限制而classifiers仅作展示。
Python 多版本共存时，typing 注解怎么写才不报错
Python 3.7+ 默认启用 from __future__ import annotations 后，注解延迟求值，但老版本（如 3.6）不支持该语法，直接写 list[str] 会触发 SyntaxError。这不是风格问题，是运行时硬性失败。
- 3.6 及更早：必须用字符串字面量，比如
"list[str]"或"Optional[int]"；typing.List、typing.Optional等需显式导入 - 3.7–3.8：可用
list[str]，但需加from __future__ import annotations才安全；否则部分工具（如mypy）可能误判 - 3.9+：原生支持标准集合类型做泛型，
list[str]、dict[str, int]直接可用，无需typing模块对应类型 - 跨版本兼容写法：统一用字符串注解 +
typing模块兜底，例如def foo(x: "list[int]") -> "Optional[str]": ...，再配合if sys.version_info >= (3, 9): ... else: ...控制运行时逻辑分支
pydantic v1 和 v2 的 BaseModel 在接口参数校验中行为差异
v2 默认禁用 extra 字段、强制执行 strict 模式，而 v1 默认宽松。服务升级后常见现象是客户端多传一个字段，v1 静默忽略，v2 直接抛 ValidationError，HTTP 接口返回 422。
- v1 中
class Config: extra = "ignore"是默认行为；v2 改为model_config = {"extra": "ignore"}，且不设则报错 - v2 的
validate_assignment=True默认关闭，赋值时不再触发验证，需手动开启；v1 是默认开启的 - 字段别名（
alias）在 v2 中必须通过Field(alias="x")显式声明，v1 支持Field(..., alias="x")但解析逻辑有细微差别，尤其在嵌套模型中易漏字段 - 若用 FastAPI，v0.100+ 强制依赖 pydantic v2，此时
Body参数若仍按 v1 写法定义，会出现TypeError: BaseModel.__init__() got an unexpected keyword argument '...'
同一接口同时支持 Python 3.8 和 3.12，async 函数签名如何保持兼容
3.12 引入了 async def 的新限制：不能在非 async 上下文中调用协程对象，而 3.8 允许隐式 await（比如直接 return 协程）。这会导致测试或 mock 场景下，3.12 报 RuntimeWarning: coroutine 'xxx' was never awaited，甚至崩溃。
- 所有
async def接口函数，调用处必须显式await，不能靠事件循环自动调度；尤其注意单元测试里用loop.run_until_complete()的写法在 3.12 已过时 - 避免在同步路径中返回协程对象，例如不要写
return fetch_data()（fetch_data是 async 函数），而应写return await fetch_data() - 若需兼容同步/异步两种实现（比如降级策略），用
asyncio.iscoroutinefunction()判断，再分发处理，而不是靠 try/except 捕获TypeError - 第三方库如
httpx.AsyncClient在 3.12 下对timeout参数类型更严格，timeout=30会被拒绝，必须传httpx.Timeout(30)
用 setuptools 声明最低 Python 版本时，python_requires 和 classifiers 的实际作用区别
python_requires 控制 pip 安装时是否允许安装，classifiers 仅影响 PyPI 页面展示和某些工具（如 pip-audit）的提示，不阻止安装。
立即学习“Python免费学习笔记（深入）”；
- 写成
python_requires=">=3.8"后，pip 在 3.7 环境下执行pip install mypkg会直接报错ERROR: Package requires Python '>=3.8' but the running Python is 3.7.17 -
classifiers=["Programming Language :: Python :: 3.8", "Programming Language :: Python :: 3.12"]只告诉 PyPI “我测过这些版本”，但用户在 3.6 上照样能pip install成功——只要没设python_requires - 常见坑：CI 中用
tox测试多个 Python 版本，但python_requires写太宽（如>=3.6），导致 3.6 环境跑 v2 的 pydantic，结果运行时报ImportError: cannot import name 'TypeAlias' from 'typing'（该符号 3.8 才引入） - 建议组合使用：
python_requires设最小可运行版本，classifiers列出已验证版本，CI 脚本里明确指定python -m pip install --no-deps避免意外拉低版本依赖
版本兼容不是“写一次跑 everywhere”，而是每个类型注解、每行 await、每次 setup.py 修改，都得确认它在目标解释器里真能过解析、过校验、过运行。最容易被跳过的，是测试环境 Python 版本和线上不一致，以及依赖包自身对 Python 版本的隐藏要求。
