您最喜欢的城市的最爱地点
首页
添加为 Google 首选来源

JSON 到 TypeScript

将普通的 JSON 示例转换为可读的 TypeScript 类型别名。检查可选字段和混合数组,然后复制代码或保存 TypeScript 文件。结果描述了观察到的结构和需求审查;它不会在运行时验证未来的数据。

JSON 示例

推断的 TypeScript

生成一个类型可以在这里查看。

本工具在此页面处理示例,不会上传或保存示例。

从 JSON 生成类型

  1. 粘贴一个 JSON 文档或加载示例。在输入限制内支持对象、数组和基本类型的根值。注释、尾随逗号、解码后重复的键以及未配对的 UTF-16 代理码元会被拒绝。
  2. 选择以 ASCII 大写字母开头,后跟字母、数字或下划线的根类型名称,最多 64 个字符。选择两个或四个空格并生成类型。
  3. 检查推断字段和仅样本资格。 Copy 只写入当前代码;下载 TypeScript 保存与 json-types.ts 相同的 UTF-8 代码。编辑输入会清除旧结果。

样本推理的工作原理

基本值会推断为 null、boolean、number 或 string。看起来像日期、标识符或数字的字符串仍是字符串。数值标记无需转换即可分类;number 不保证 JavaScript 数值精度。

同一上下文中的对象会合并。只有当某个对象缺少该键时,该键才是可选的。显式 null 是一个值,因此可选与可为 null 不同。空对象也参与判断。

数组递归合并观察到的元素,而不是生成固定长度的元组。同一上下文中的空数组可使用非空数组的元素信息;如果没有任何元素,则使用 unknown[]。不同属性路径不会共享信息。

结果是一种具有内联嵌套类型、带引号的键和稳定格式的导出类型别名。没有键的对象池使用 unknown 值字符串索引签名,这是许可的而不是完全空的。不应用枚举、判别式、字典、日期或 UUID 启发式。

必需、可选和可为 null 的示例

示例中的第一个对象包含 id 1、label Ada 和 score null;第二个包含 id 2 和 score 4。id 和 score 在两个对象中都存在,因此是必需的。label 只出现一次,因此是可选的。score 的类型为 null | number。

对于 left 字段为空数组且 right 字段包含 1 的对象, left 保持为 unknown[] , right 变为 number[] 。对于两个对应的 items 数组(一个为空,一个包含 1),它们的共享元素证据会生成 number[] 。

合并带有 kind ok 和 value 的对象与带有 kind error 和 message 的对象后,kind 变为字符串,value 和 message 变为可选字段。原有的对应关系会丢失,类型可能允许样本中未出现的组合。需要可辨识联合类型时,请手动检查。

推理和大小限制

一个样本无法确定未来的每个字段、缺失值或变体。生成的声明是编译时类型,而不是运行时验证器、精确的对象模式或 API 响应正确性的证明。

输入限制为 256 KiB UTF-8 文本、深度 32 和 20000 条记录。每个 JSON 值计数一次,每个对象成员再添加两条记录。输出限制为 1 MiB,包括格式及其最终换行符。限制拒绝整个操作而不截断结果。

只允许在开头使用一个 BOM。作为互操作性限制,解码后重复的名称和未配对的 UTF-16 代理码元会被拒绝。数值标记最多 1024 个字符,指数绝对值最多 100000;不会推断 bigint 或保证数值精度。

该工具接受 JSON 文本并发出类型别名。它不会导入文件或 URL、执行示例、生成接口或运行时代码、推断 JSON 架构、翻译密钥或在浏览器中安装编译器。查看您将在其中使用它们的 TypeScript 项目中的声明。

示例和代码保留在此页面的工作流程中

本工具不会上传示例、保存历史记录、创建包含输入的链接,或添加包含 JSON、键名、类型名或生成代码的遥测数据。仅在请求时复制或下载。此说明不涵盖现有网站服务、扩展程序及您之后对代码的使用。

JSON 到 TypeScript 的问题

如果合并组中至少有一个对象缺少该属性,它就是可选的。null 是明确观察到的值,会出现在值类型中。属性可以是必需但可为 null、可选但不含 null,也可以同时可选且可为 null。

没有元素的数组上下文使用 unknown[];同一上下文中的非空数组可以提供元素信息。没有键的对象组使用值为 unknown 的字符串索引签名,不保证对象为空。

数值标记直接归类为 number,不计算其值。推断过程无需转换数值,但生成的 number 类型不保证任意精度,也不会推断 bigint。解析器的标记长度和指数限制仍然适用。

不会。原始值被拓宽,相应的对象字段被合并。标签和其他字段之间的关系可能会丢失,从而允许示例中未出现的组合。查看这些案例并在您的项目中明确建模预期的变体。

根别名使用记录的大写优先 ASCII 名称规则。数据键保持独立:它们被解码并发出为转义的带引号的属性,包括空格、空名称、Unicode 和原型名称。密钥不会被重命名或用作可执行源。

不会。类型声明不执行运行时检查。成功的编译在测试的编译器设置下建立了语言/类型契约,而不是真实 API 模式的完整性或未来数据的有效性。

两种操作都只包含当前生成的代码,不含页面标题或 Markdown 标记。下载的 json-types.ts 使用无 BOM 的 UTF-8,并以一个换行符结尾。修改输入或设置会使旧结果失效。

该工具既不添加转换服务器上传,也不添加保存的示例历史记录或数据承载 URL。它在页面中执行此转换。现有的网站服务和扩展不在此限制声明范围内;使用您平常关心的私人样本和生成的属性名称。

来源和参考文献

资料审阅日期:2026-11-15。合并、命名和限制由本工具规定。

JSON 转 YAML

在本地将 JSON 转换为 YAML,保留数字原文和带引号的字符串;复制或下载完整结果。

打开工具 — JSON 转 YAML

YAML 转 JSON

在本地将一个 YAML 文档转换为 JSON,保留精确数字文本,然后复制或下载结果。

打开工具 — YAML 转 JSON

YAML 格式化工具

调整 YAML 缩进,复制通过检查的结果,同时保留注释和原文细节。

打开工具 — YAML 格式化工具

XML 格式化工具

在本地检查 XML 1.0 的良构性和命名空间绑定,格式化或压缩文本,并复制或下载 UTF-8 结果。

打开工具 — XML 格式化工具

JSON 格式化与验证

在本地检查 JSON 语法、格式化或压缩,并在保留原始数据的同时复制或下载结果。

打开工具 — JSON 格式化与验证
查看此分类中的所有工具