跳到主要内容
← 返回

JSON 扁平化工具 - 嵌套/扁平 JSON 互转

数据
本地运行 · 不上传

免费在线 JSON 扁平化工具,一键将嵌套 JSON 结构扁平化为点分隔的键值对,或从扁平化 JSON 还原为嵌套结构。支持自定义分隔符(点、下划线、斜杠等),方便数据处理和 API 调试。

结果有帮助吗?

本地工具可在 DevTools → Network 搜索输入内容,通常不会出现在请求中。

下一步

使用指南

嵌套 JSON 在表格、日志检索与部分配置系统里不好用。本工具支持扁平化与还原双向模式,分隔符可选点号、下划线、斜杠或短横线;数组下标写成 [0] 形式。解析走无损路径,本地完成。

1. 扁平化或还原

选择扁平化把嵌套对象打成单层键值;选择还原把分隔键拼回嵌套结构。模式切换时可把当前输出送回输入,方便来回验证。

  1. 粘贴 JSON。
  2. 选模式与分隔符。
  3. 复制结果或切换模式回验。

2. 分隔符怎么选

点号最常见(user.name)。若键名本身含点,改用下划线、斜杠或短横线,避免歧义。还原时必须使用与扁平化时相同的分隔符,否则路径会拆错。

  • 键含点时换分隔符。
  • 往返使用同一分隔符。
  • 先对小样例回验。

3. 数组下标

数组会展开为 path[0]、path[1] 这类键。空数组/空对象在带前缀时会保留为空容器,避免信息丢失。还原后检查数组是否仍是数组而非「数字键对象」。

4. 适用场景

把 API 响应当表格列;给日志系统造可检索字段;对比两份配置时先扁平再做键级对比。不适合当作数据库范式设计的唯一依据。处理含个人信息或密钥的内容时,即使计算在本地完成,也要留意屏幕分享、录屏与下载文件的二次传播路径。

5. 与排序、对比

扁平化前用 json-sorter 统一键序,文本 diff 更稳;结构差异大时用 json-diff。路径查询需求则看 jsonpath-query。遇到异常输出时,先用最小可复现样例确认是输入问题还是选项组合问题,再考虑换相关工具衔接下一步,而不是一次性堆很多选项。

6. 边界与交接

键名含分隔符、极端深嵌套会导致意外。先用中小样例确认约定,再处理生产导出。若结果给他人,补充分隔符、模式与已知边界说明,避免口口相传丢失前提。若结果要给其他人使用,补充一行说明:数据来源、转换选项、以及已知不保证的边界,避免口口相传丢失前提。

常见问题

把嵌套对象树压成单层键值对:嵌套键用分隔符连接,例如 {"a":{"b":1}} → {"a.b": 1}。数组用方括号下标,如 items[0].name。

点号(.)、下划线(_)、斜杠(/)、短横线(-)。点号最常见(user.name),但键名本身含点时应换用其他分隔符;扁平化与还原必须使用同一分隔符,否则路径会拆错。

可以。双向转换,切换模式时可把当前输出填回输入做往返验证。解析走无损路径,大整数不丢精度;循环引用不支持。

数组展开为 path[0]、path[1] 这类键;空数组与空对象在带前缀时会保留为空容器,避免信息丢失。还原后要抽查数组是否仍是数组,而不是变成了「数字键对象」。

扁平化前先用 json-sorter 统一键序,文本 diff 更稳;结构差异大时改用 json-diff;按路径查字段看 jsonpath-query。扁平化适合把 API 响应变成表格列、做配置的键级对比、给日志造可检索字段,但它只改变形状,不替代 Schema 校验。

不会。扁平化与还原都在浏览器本地执行,页面不发起上传请求,你的 JSON 不经任何中转。

相关工具

相关文章