跳至主要内容

JSON 转 Python 类

将 JSON 转换为 Python 的 Pydantic v2 模型、dataclass 或 TypedDict,带类型提示,为 camelCase 键提供别名,并能识别 datetime/UUID。

100% 客户端 · 没有数据离开您的浏览器

Pydantic parses them for you

Python — 3 types
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. 1

    粘贴 JSON

    粘贴一个 JSON 对象,或一个示例数组。

  2. 2

    选择风格

    选择 Pydantic、dataclasses 或 TypedDict。

  3. 3

    复制代码

    复制类或下载 models.py。