Python 数据结构演进的向后兼容设计

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 在作用域内
• 第三方库如 pydantic 2.x 默认依赖此特性，但若你封装了自定义的类型解析逻辑，很可能漏掉字符串转类型的步骤

复杂点在于：向后兼容不是单点切换，而是版本、工具链、团队习惯的耦合体。最容易被忽略的是测试环境 Python 版本和 CI 中 mypy 配置不一致，导致本地过、CI 报错。

立即学习“Python免费学习笔记（深入）”；