JSON格式化方法大全
格式化不是把 JSON「变漂亮」这么简单:缩进方便人读,压缩方便传输,失败时要先修语法。下面按场景选方法,而不是每一种都试一遍。
什么是JSON格式化?
JSON 格式化(也叫美化、pretty-print)是在不改变数据含义的前提下,按层级插入换行和缩进。反过来把空白去掉、压成一行,叫压缩或 minify。两者操作的都是同一棵树:键的顺序在对象里本就不保证业务含义,但字符串内容、数字和嵌套关系必须原样保留。
你在 Network 面板里看到的经常是压缩后的响应,为的是省流量。人要对字段时,需要先展开。日志或 curl 示例有时又要求单行,避免换行被壳拆坏。所以「格式化」和「压缩」是同一件事的两个方向,不必拆成两个网站。
如果文本根本不是合法 JSON,格式化不应该猜着改写。单引号、尾逗号、注释,都该报错而不是悄悄修。语法层面请用 JSON校验器;概念不清楚时先读 JSON是什么。
为什么需要格式化?
嵌套三层以上时,一行文本里的括号会把 data.user.profile 和隔壁字段糊在一起。缩进 2 空格是接口调试的默认选择:层级清楚,也不像 8 空格那样把屏幕占满。
压缩则出现在:要贴进 issue、写入环境变量、或重新放进请求体。多出来的空白会改变字节长度,但不应改变解析结果。若压缩前后校验结果不一致,说明中间有人改过文本,而不是「压缩坏了」。
团队里还常见第三种需求:对照两份 JSON 是否只差空白。应先双方都格式化(或都压缩)再 diff,否则满屏都是空格差异。本站文本对比适合日志片段,不替代 Git。
如何格式化JSON?
浏览器里最快的是打开 JSON格式化工具,粘贴后点格式化。同一页可以再压缩。解析失败会提示,而不会把 {id:1} 擅自加上引号。适合偶发联调,数据默认留在本地。
经常处理文件时,本地命令更合适:python -m json.tool、jq .、编辑器的 Format Document。它们和在线工具解决的是同一棵树,只是入口不同。在线页的价值是:你现在手上只有一段从聊天软件拷出来的字符串,不想先存盘。
失败时的顺序应当固定:停掉反复格式化 → 看第一处语法错误 → 校验器确认 → 改完再展开。缺逗号时,校验器往往比「整段变红」更接近列号。改的是文本,不是去换一个「更强的美化网站」。
按场景选方法,而不是堆工具
只要看清字段:在线格式化即可,缩进 2 空格足够。要核对语法:先校验,再格式化。要生成代码类型:格式化只是前奏,真正的下一步是 JSON 转 TypeScript 或 JSON 转 Go,见 JSON工具大全。
不要把生产密钥、完整用户表贴到任何网页。本站格式化在本地完成,但公共电脑和屏幕分享仍不安全。体积很大的文件(几十 MB)更适合 jq 或脚本,浏览器页为的是接口量级的样例。
「JSON格式化方法大全」在搜索里常被理解成「越多网站越好」。有用的只有三类:看树、查语法、压单行。其余换皮页不会多教你什么。把这三类做熟,比收藏二十个书签有效。
相关工具
常见问题
格式化和压缩会改字段值吗?
合格的实现只改空白。若数字精度、键顺序或转义看起来变了,先确认原始文本是不是合法 JSON,以及语言的 Number 是否撑不住大整数。
为什么点了格式化没有任何变化?
可能已经是缩进过的文本,或解析失败被中止。看页面提示;失败就去校验,不要换一个「强制美化」的站——那往往在改你的数据。
缩进用 2 个空格还是 Tab?
接口样例用 2 空格最常见。Tab 和 4 空格也能解析,但和同事 diff 时会吵。选一种并在提交前统一。
能不能格式化半截 JSON?
不能当合法文档。缺括号的片段会失败。先补全根节点,或只抽取一个完整对象再贴。
和 JSON 校验有什么区别?
格式化的目标是读和传;校验的目标是回答「是不是 JSON」。失败时应先校验。