如何针对返回国际化输出的API做Python typing多语言适配

你可以通过泛型+协议约束的方式实现，无需为每种语言单独编写类型定义，核心思路是把结构语义和多语言键名解耦，只约束字段的类型规则，不绑定具体的键名字面量。

具体实现方案 #

方案1：协议约束（推荐，适配性最强） #

不管不同语言的键名是什么，只要结构的语义和值类型一致，就可以用Protocol定义通用结构协议，再结合TypeVar做泛型标注：

from typing import Sequence, TypeVar, Protocol, Any

# 定义车辆结构的通用协议，约束所有语言版本的结构访问规则
class VehicleStructure(Protocol):
    # 约束结构支持字典式访问，也可以根据你的业务逻辑补充通用方法约束
    def __getitem__(self, key: str) -> Any: ...

# 定义绑定协议的类型变量
T = TypeVar("T", bound=VehicleStructure)

# 泛型函数适配任意符合协议的多语言结构
def update_vehicles(vehicles: Sequence[T]) -> Sequence[T]:
    # 你的业务逻辑实现
    return vehicles

这种方案的优势是后续新增支持的语言时，不需要修改任何类型标注，只要返回结构符合协议规则就能通过类型检查。

方案2：映射表+泛型（适合键名可枚举的场景） #

如果你的多语言键名是固定可枚举的，可以把键名映射抽成统一配置，结合Literal实现更严格的类型校验：

from typing import Sequence, TypeVar, Literal

# 枚举支持的语言
SupportLang = Literal["en", "de"]

# 统一维护语义字段到各语言键名的映射，新增语言只需要加这个配置
FIELD_KEY_MAP: dict[SupportLang, dict[str, str]] = {
    "en": {"root": "vehicle", "model": "model"},
    "de": {"root": "fahrzeug", "model": "modell"}
}

T = TypeVar("T", bound=SupportLang)

如果你不需要强校验键名，只需要保证嵌套结构和值类型一致，也可以直接用dict[str, dict[str, Any]]这类通用结构标注，不过类型检查的严谨度会有所下降。

内容的提问来源于stack exchange，提问作者Kevin Engle