JSON 扁平化工具
将嵌套 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 风格的路径工具都采用它),因此输出易于阅读,也便于可靠地逆向还原。
使用方法
- 将 JSON 粘贴或输入到输入框中。
- 选择展平以压缩数据,或选择还原嵌套以将扁平对象展开回嵌套 JSON。
- 如果你希望对象键之间使用
_或/,可以选择性地修改键分隔符。 - 复制或下载格式化后的结果。结果会随你的输入实时更新。
展平
递归遍历解析后的 JSON,为每个叶子值(字符串、数字、布尔值或 null)输出一个条目。结果本身是有效的 JSON,并以两空格缩进进行格式化。
还原嵌套
按分隔符和方括号中的索引拆分每个键,然后重建嵌套的对象和数组。使用相同分隔符先展平再还原,即可得到原始结构。
试用示例
使用内置示例,可以查看嵌套对象的展平结果、嵌套数组的展平结果,以及扁平对象还原为嵌套 JSON 的效果。
常见问题
它会改变我的数字或布尔值吗?
不会。叶子值会被原样保留,改变的只是键的结构。空对象和空数组同样作为叶子值保留。
应该选择哪种分隔符?
不确定时使用点号,它是默认值,也最常见。如果目标系统保留了点号,或要求使用路径式的键,则可选择下划线或斜杠。
我的数据会被上传到其他地方吗?
不会。展平和还原完全在你的浏览器中运行。粘贴的内容不会发送到服务器,因此适用于私密或敏感的 JSON。