JSON 转 Python 类转换器

什么是 JSON 转 Python？

示例

{"id":101,"name":"Ada Lovelace","email":"ada@example.com","active":true,"roles":["admin","user"]}

from dataclasses import dataclass
from typing import List


@dataclass
class Root:
    id: int
    name: str
    email: str
    active: bool
    roles: List[str]

{"repo":"pydantic","owner":{"login":"samuelcolvin","id":100}}

from dataclasses import dataclass


@dataclass
class Owner:
    login: str
    id: int


@dataclass
class Root:
    repo: str
    owner: Owner

{"login":"octocat","publicRepos":15,"createdAt":"2011-01-25"}

from pydantic import BaseModel, ConfigDict, Field


class Root(BaseModel):
    model_config = ConfigDict(populate_by_name=True)

    login: str
    public_repos: int = Field(alias="publicRepos")
    created_at: str = Field(alias="createdAt")

{"users":[{"id":1,"nick":"x"},{"id":2}]}

from typing import List, Optional, TypedDict


class User(TypedDict):
    id: int
    nick: Optional[str]


class Root(TypedDict):
    users: List[User]

如何将 JSON 转换为 Python

1. 1

   粘贴你的 JSON

   将 JSON 对象、数组或 API 响应放入输入框，转换即刻开始。

2. 2

   选择 dataclass、Pydantic 或 TypedDict

   切换输出风格以匹配你的项目，并把根类从默认的 Root 重命名。

3. 3

   复制或下载

   一键获取生成的 Python 代码，直接粘贴到你的代码中。

Common Use Cases

带类型的 API 客户端

将 REST 或 GraphQL 响应示例转换为 Pydantic 模型或 dataclass，用于 requests 或 httpx 客户端，无需手写字段定义。

配置与夹具解析

为需要加载并校验的 JSON 配置文件、测试夹具或 webhook 负载生成模型。

快速原型与类型提示

粘贴一个不熟悉的负载，即时看到它作为 Python 类型的结构 — 快速探索新 API，或为遗留的 dict 代码补上 TypedDict 提示。

转换原理

结构推断

每个对象都会成为一个命名类；结构相同的会被去重，因此你得到的是一个类而非多份副本。对象数组会逐键合并，部分元素缺失的键会变成 Optional。

三种地道目标

dataclass 零依赖，并保留合法键以便 Root(**data)；Pydantic v2 添加 Field 别名及 populate_by_name 以实现真正的校验；TypedDict 为静态类型检查器描述普通 dict，当键不是标识符时使用函数式语法。

正确且轻依赖的类型标注

整数映射为 int（任意精度，不会溢出），小数和指数映射为 float，只有 null 的字段映射为 Optional[Any]。typing 的导入（Optional、List、Any）只有在实际用到时才会添加。

100% 浏览器端

解析和生成都在浏览器中运行，没有任何网络请求，因此你的数据保持私密。

编写整洁 Python 模型的技巧

让模式匹配用途

内部数据容器用 dataclass，需要校验或解析不可信输入时用 Pydantic v2，只需为现有 dict 加静态类型提示时用 TypedDict。

粘贴有代表性的样本

只有当某样本省略某字段时它才会被标记为 Optional，而只有 null 的值会回退到 Any。一个填充完整的示例能得到最精确的类型。

为根类命名

设置一个有意义的根名称（如 User、ApiResponse），而非默认的 Root，让代码更易读、更便于导入。

常见问题