JSON 转 Python 类
将 JSON 转换为 Python 的 Pydantic v2 模型、dataclass 或 TypedDict,带类型提示,为 camelCase 键提供别名,并能识别 datetime/UUID。
Pydantic parses them for you
from datetime import datetime
from typing import Any
from pydantic import BaseModel, Field
class Address(BaseModel):
street: str
city: str
zip_code: str = Field(alias="zipCode")
class Order(BaseModel):
order_id: str = Field(alias="orderId")
total: float
items: int
shipped: bool
coupon: str | None = None
class Root(BaseModel):
id: int
username: str
email: str
is_active: bool = Field(alias="isActive")
rating: float
created_at: datetime = Field(alias="createdAt")
avatar_url: Any = Field(alias="avatarUrl")
tags: list[str]
address: Address
orders: list[Order]
Arrays of objects are merged: a key missing from some items becomes optional, null makes a field nullable, and identical shapes share one type. Paste several examples in an array for the most accurate types.
关于此工具
粘贴 JSON,即可得到带类型的 Python 模型。您可以选择 Pydantic v2 BaseModel(字段使用 snake_case,并为 createdAt 等键使用 Field(alias=…),还提供由 Pydantic 自动解析的 datetime、date 和 UUID 类型)、标准库 dataclasses,或用于标注普通字典的 TypedDict。可选键会变成 X | None = None(在 TypedDict 中为 NotRequired),嵌套对象会生成独立的类并在使用前定义,列表变成 list[T],以 ID 为键的对象变成 dict[str, T]。Python 关键字和 Pydantic 自身的方法名会被安全地重命名。导入按 isort 的方式分组,间距遵循 Black 风格。您还可以在同一页面切换到 Go、Rust、C# 或 Kotlin。
如何将 JSON 转换为 Python 模型
根据 JSON 生成 Pydantic 模型或 dataclass。
- 1
粘贴 JSON
粘贴一个 JSON 对象,或一个示例数组。
- 2
选择风格
选择 Pydantic、dataclasses 或 TypedDict。
- 3
复制代码
复制类或下载 models.py。