跳到主要内容

JSON 扁平化工具

API reference

将嵌套 JSON 展平为单层对象,键使用点号和方括号路径(user.roles[0]),也可将扁平键还原为嵌套 JSON。可选择键分隔符,并获得格式化的输出。

输入

连接嵌套对象的键。数组索引始终使用 [N]。

输出

结果
 
这对您有帮助吗?

使用此工具的更多方式

REST API

curl -X POST https://api.iotools.cloud/v1/tool/json-flattener \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": "{\"user\":{\"name\":\"Ada\",\"roles\":[\"admin\",\"dev\"]},\"…",
    "mode": "flatten",
    "delimiter": "."
  }'

替换成您账户中的密钥。工具的字段即为请求体——没有额外包装。

让 AI 代理执行

Use the IOTools `json-flattener` tool (JSON Flattener) on this input:

YOUR_INPUT_HERE

将此粘贴给任何已连接 IOTools MCP 服务器的代理,再加上您的输入内容。

嵌入式小组件

<iframe
  src="https://iotools.cloud/embed/json-flattener/"
  width="100%" height="520" frameborder="0" scrolling="no" loading="lazy"
  title="JSON 扁平化工具 — iotools.cloud"
  sandbox="allow-scripts allow-forms allow-same-origin allow-downloads allow-popups allow-popups-to-escape-sandbox"
  allow="clipboard-write"
  style="width:100%;border:1px solid #e5e7eb;border-radius:12px;overflow:hidden"></iframe>
<script src="https://iotools.cloud/embed.js" async></script>

把它放到您自己的页面上——免费,无需密钥,只需保留一个反向链接。

每次 API/MCP 调用费用5 积分起
需要更多积分?查看定价

也可通过

使用指南

JSON 扁平化工具可将深度嵌套的 JSON 对象或数组转换为单层对象,其键为易读的路径字符串;也可以把这些扁平键重新还原为嵌套 JSON。粘贴数据,选择模式,然后复制格式化后的结果。

功能说明

嵌套 JSON 不便于用于电子表格、.env 风格的配置、表单字段以及期望扁平键值对的日志管道。展平会把 {"user":{"roles":["admin","dev"]}} 这样的结构改写为:

{
  "user.roles[0]": "admin",
  "user.roles[1]": "dev"
}

输出中的每个值都是原始文档中的叶子节点,其键为到达该节点的完整路径。还原则是这一过程的逆向操作:根据这些路径键重新构建原始的对象和数组。

键路径规则

  • 对象键使用你选择的分隔符连接,默认为点号(.),也可以选择下划线(_)或斜杠(/)。
  • 数组索引始终使用方括号 [N] 表示,因此即使键中包含分隔符,tags[0] 也不会产生歧义。

这种点号与方括号混合的风格是最广为人知的扁平键格式(许多表单库和 lodash 风格的路径工具都采用它),因此输出易于阅读,也便于可靠地逆向还原。

使用方法

  1. 将 JSON 粘贴或输入到输入框中。
  2. 选择展平以压缩数据,或选择还原嵌套以将扁平对象展开回嵌套 JSON。
  3. 如果你希望对象键之间使用 _ 或 /,可以选择性地修改键分隔符。
  4. 复制或下载格式化后的结果。结果会随你的输入实时更新。

展平

递归遍历解析后的 JSON,为每个叶子值(字符串、数字、布尔值或 null)输出一个条目。结果本身是有效的 JSON,并以两空格缩进进行格式化。

还原嵌套

按分隔符和方括号中的索引拆分每个键,然后重建嵌套的对象和数组。使用相同分隔符先展平再还原,即可得到原始结构。

试用示例

使用内置示例,可以查看嵌套对象的展平结果、嵌套数组的展平结果,以及扁平对象还原为嵌套 JSON 的效果。

常见问题

它会改变我的数字或布尔值吗?

不会。叶子值会被原样保留,改变的只是键的结构。空对象和空数组同样作为叶子值保留。

应该选择哪种分隔符?

不确定时使用点号,它是默认值,也最常见。如果目标系统保留了点号,或要求使用路径式的键,则可选择下划线或斜杠。

我的数据会被上传到其他地方吗?

不会。展平和还原完全在你的浏览器中运行。粘贴的内容不会发送到服务器,因此适用于私密或敏感的 JSON。

jsonflattenunflattendot-notationdeveloper

工作流的一部分

全部工具集

喜欢这些工具?去掉广告吧。

一次性付款即可永久移除您账户中的所有广告。无需订阅,不追踪。