JSON 转 Python 工具
生成带 JSON 映射函数的 Python dataclass,或 Python 3.11 TypedDict 定义,支持嵌套结构及可选字段。
如何生成 Python 模型
粘贴有代表性的 JSON 对象或数组,填写根类型名称后生成。使用文件选择框查看各个源码文件;复制仅复制当前文件,ZIP 下载保留全部文件。完整输出通过映射保留 JSON 原始字段名,包括语言关键字和含标点的键名。
dataclass 输出使用 Python 3.7 及以上的标准库,from_dict/to_dict 函数将 JSON 键映射到合法属性;仅模型模式省略转换函数。TypedDict 使用 Python 3.11 及以上的 NotRequired,直接保留连字符、关键字等原始键名。类型注解不会自动进行运行时校验。
样本、可选字段与限制
同类接口存在多种返回结构时,可选择 JSON Lines,每行放一个完整 JSON 文档。部分样本缺少的字段推断为可选字段,显式 null 参与可空类型推断。空数组和始终为 null 的字段无法确定具体类型,应补充代表性样本并核对输出。
数字样式字符串、日期和 UUID 字符串仍按字符串处理。工具根据样本推断模型,不能代替完整接口约定。上限为 200,000 字符、64 层嵌套、50 个样本文档、50 个生成文件及 1,000,000 输出字符。转换在本地 Worker 中运行,可取消,超时为 10 秒。
常见问题
缺失字段和 null 一样吗?
不同。缺失字段表示该字段不一定存在,null 则是一个具体值。目标语言可能通过同一个可选或可空类型表示两者。建议提供多个样本,仅在符合实际接口时启用“所有字段可选”。
会读取远程 Schema 或上传 JSON 吗?
不会。工具仅使用输入的 JSON 样本,不读取其中的网址或远程 Schema,也不会在页面中执行生成的程序。