如何在Python中使用type语句精确描述字典结构？

我之前用Go和TypeScript开发，现在回到Python，发现了type语句。我尝试用它精确描述字典结构，但只找到泛型写法：

from typing import Dict, Any

type Car = Dict[str, str]  # 或 Dict[str, Any] 等

我的实际字典结构如下：

{
    "color": "blue",
    "max_nr_passengers": 26,
    "seats": [
        {
            "color": "green",
            "heated": true
        },
        {
            "color": "blue",
            "heated": true
        }
    ],
    "options": {
        "guns": false,
        "submarine": false,
        "extra_wheels": 18
    }
}

我希望能像Go中用struct那样精确描述该结构以获得真实的类型提示，比如Go的写法：

type Car = struct {
    Color String
    MaxNrPassengers Int
    Seats []struct {
        Color String
        Heated Bool
    }
    Options struct {
        Guns Bool
        Submarine Bool
        ExtraWheels Int
    }
}

请问Python中能否实现这样的精确类型描述？

当然可以，Python有几种方式实现这种结构化的类型描述，以下是最常用的方案：

1. 使用标准库 TypedDict（推荐，Python 3.8+） #

TypedDict 是Python标准库typing模块中专门用来标注字典结构化类型的工具，完全能实现类似Go struct的精确类型提示，支持嵌套结构：

from typing import TypedDict, List

class Seat(TypedDict):
    color: str
    heated: bool

class CarOptions(TypedDict):
    guns: bool
    submarine: bool
    extra_wheels: int

class Car(TypedDict):
    color: str
    max_nr_passengers: int
    seats: List[Seat]
    options: CarOptions

定义后，编辑器会对符合Car结构的字典提供精确的字段类型提示，也能检测字段名错误或类型不匹配的问题。

2. 使用 dataclasses（Python 3.7+） #

如果需要的不仅是类型提示，还要能实例化结构化对象（可方便转换为字典），可以用dataclasses配合类型标注：

from dataclasses import dataclass
from typing import List

@dataclass
class Seat:
    color: str
    heated: bool

@dataclass
class CarOptions:
    guns: bool
    submarine: bool
    extra_wheels: int

@dataclass
class Car:
    color: str
    max_nr_passengers: int
    seats: List[Seat]
    options: CarOptions

# 实例化对象
my_car = Car(
    color="blue",
    max_nr_passengers=26,
    seats=[Seat("green", True), Seat("blue", True)],
    options=CarOptions(False, False, 18)
)

# 转换成字典
my_car_dict = my_car.__dict__

这种方式的优势是可以直接操作对象而非字典，同时保留完整的类型提示。

3. 第三方库 Pydantic（适合数据验证场景） #

如果需要额外的数据验证、自动类型转换或序列化/反序列化功能，可以使用Pydantic库（需先安装：pip install pydantic）：

from pydantic import BaseModel
from typing import List

class Seat(BaseModel):
    color: str
    heated: bool

class CarOptions(BaseModel):
    guns: bool
    submarine: bool
    extra_wheels: int

class Car(BaseModel):
    color: str
    max_nr_passengers: int
    seats: List[Seat]
    options: CarOptions

# 从字典解析并验证
car_dict = {
    "color": "blue",
    "max_nr_passengers": 26,
    "seats": [{"color": "green", "heated": True}, {"color": "blue", "heated": True}],
    "options": {"guns": False, "submarine": False, "extra_wheels": 18}
}

my_car = Car(**car_dict)
# 转换成字典
my_car_dict = my_car.dict()

Pydantic会自动验证输入数据的类型和字段完整性，非常适合处理API请求、配置文件等场景。

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