Python 3.7+ dict 保证插入顺序，但 OrderedDict 特有方法（如 move_to_end）和等值比较行为不可替代；PEP 585 类型注解需匹配 Python 版本与 mypy 配置；__future__.annotations 要求显式处理字符串化类型。
Python 3.9+ 的 dict 保留插入顺序，但旧代码依赖 collections.OrderedDict 怎么办？
dict 自 Python 3.7 起保证插入顺序，3.9 正式写入语言规范。但很多老项目仍显式用 OrderedDict，尤其在需要 move_to_end() 或 popitem(last=False) 的场景——这些方法 dict 没有。
- 如果只是想“保持顺序”，直接换
dict即可，兼容性无风险（3.7+） - 如果用了
OrderedDict的特有方法，不能直接替换，否则运行时报AttributeError -
OrderedDict和dict的等值比较行为不同：OrderedDict(a=1, b=2) == OrderedDict(b=2, a=1)是False，而对应dict是True；测试里若依赖该行为，会悄无声息出错 -
OrderedDict内部是双向链表实现，内存开销比dict高约 2–3 倍，高频构造时要注意
从 typing.List 迁移到 list（PEP 585）后，mypy 和运行时表现不一致？
Python 3.9 引入 PEP 585，允许直接用内置类型如 list[int] 替代 typing.List[int]。但 mypy 默认只检查语法，不校验运行时是否支持——比如在 3.8 环境下跑含 list[int] 的代码，会抛 TypeError: 'type' object is not subscriptable。
- 运行前务必确认 Python 版本 ≥ 3.9；若需兼容 3.8，保留
typing.List或用字符串字面量"list[int]"延迟求值 -
mypy需加--python-version 3.9才能正确识别list[int]为合法类型注解，否则可能误报 -
typing.List在 3.9+ 已弃用（DeprecationWarning），但不会被移除，短期混用无害；长期应统一为list - 注意：
collections.abc.Sequence[int]等抽象基类不支持 PEP 585，仍得用typing.Sequence[int]
__future__.annotations 开启后，get_type_hints() 返回字符串而非实际类型？
启用 from <strong>future</strong> import annotations 后，所有类型注解变成字符串字面量，这是为了打破循环引用、提升启动速度。但如果你手动调用 typing.get_type_hints(obj)，默认行为是自动求值——这时若注解里有未定义的名称（比如前向引用没加引号），就会抛 NameError。
- 显式传参
include_extras=True和eval_str=True（后者 3.10+ 默认开启，3.9 需指定）才能安全求值 - 若函数参数带
Union或Optional，且未导入typing，求值时会失败；建议统一用|语法（3.10+）或确保typing在作用域内 - 第三方库如
pydantic2.x 默认依赖此特性，但若你封装了自定义的类型解析逻辑，很可能漏掉字符串转类型的步骤
复杂点在于：向后兼容不是单点切换，而是版本、工具链、团队习惯的耦合体。最容易被忽略的是测试环境 Python 版本和 CI 中 mypy 配置不一致，导致本地过、CI 报错。
立即学习“Python免费学习笔记（深入）”；
