如何在Python向后兼容代码中使用类型提示且无需独立代码库？

很遗憾，并没有from __future__ import type_hints这样的魔法导入——类型提示是Python 3.5才正式引入的语法特性，更早的版本（包括Python 2.7和Python 3.4及以前）并不支持def func(a: int) -> int这种直接的语法写法。不过我们有几种简便的方案，既能让代码在旧版本运行，又不用维护两套代码库：

1. 注释式类型提示（最通用的兼容方案） #

这是PEP 484官方推荐的兼容旧版本的方式，不管是Python 2.7还是Python 3.4及更早版本都能完美运行，同时类型检查工具（比如mypy）也能识别这些注释。

写法示例：

def add(a, b):
    # type: (int, int) -> int
    return a + b

def get_user_names(users):
    # type: (list[dict]) -> list[str]
    return [user["name"] for user in users]

旧版本Python会直接忽略这些注释，完全不影响运行；新版本的类型检查工具则会读取注释里的类型信息进行校验。

2. 字符串形式的类型提示 #

在Python 3.5到3.8中，支持用字符串来写类型提示（PEP 484也允许这种形式），这种写法在Python 3.4及更早版本中也不会报错——因为字符串是合法的表达式，运行时会被直接忽略。

写法示例：

def greet(name: 'str') -> 'str':
    return "Hello, {}".format(name)

def process_numbers(numbers: 'list[int]') -> 'float':
    return sum(numbers) / len(numbers)

这种写法更接近现代类型提示的语法，同时兼容旧版本，只需要注意Python 2.7里不能用f-string这类新版本特性即可，类型提示的部分不受影响。

3. 结合typing模块的Backport #

如果你的代码里需要用到List、Dict这类泛型类型，可以先安装typing模块的兼容包：

• 对Python 2.7和Python 3.3-3.4，执行pip install typing
• 然后在代码里做条件导入，避免旧版本找不到模块报错：

try:
    from typing import List, Dict
except ImportError:
    # 定义空的占位类，让旧版本运行时不报错
    class List:
        pass
    class Dict:
        pass

def update_user(users: List[Dict[str, str]], user_id: str, new_data: Dict[str, str]) -> None:
    for user in users:
        if user["id"] == user_id:
            user.update(new_data)

这种方式能让你用接近现代的类型提示语法，同时兼容旧版本，唯一的小成本是需要安装兼容包。

关于Python 3中兼容性的说明 #

你提到的Python 2.7的兼容方法（比如注释式类型提示），在Python 3的所有版本（包括3.4及更早）中都是完全适用的——因为注释在任何Python版本里都不会影响运行，类型检查工具也能跨版本识别这些注释。

总结一下，最省心的方案是注释式类型提示，不需要额外依赖，兼容所有旧版本，还能正常被类型检查工具识别；如果更倾向现代语法，字符串形式或结合typing backport也是不错的选择。

内容的提问来源于stack exchange，提问作者Rob Rose