格式化

JSON 格式化

JSON 数据格式化、压缩和校验

输入 JSON
格式化结果
格式化结果将显示在这里
✨ AI 智能类型生成 (TypeScript)
点击右上角按钮,AI 将为您当前解析成功的 JSON 生成精确的 TypeScript Interface

什么是 JSON 格式化?

JSON(JavaScript Object Notation)是一种轻量级的数据交换格式。JSON 格式化工具可以将压缩的 JSON 字符串转换为易于阅读的格式,添加适当的缩进和换行,方便开发者查看和编辑数据结构。

功能特点

  • 格式化:自动解析并格式化 JSON 数据,美化代码结构
  • 压缩:压缩 JSON 数据,移除所有空白字符,减小文件大小
  • 语法校验:实时检查 JSON 语法错误
  • 自定义缩进:支持 2 空格、4 空格、Tab 缩进
  • 压缩率显示:实时显示压缩比例和大小变化
  • 快速复制:一键复制格式化或压缩结果

使用场景

  • API 接口调试:格式化接口返回的 JSON 数据
  • 配置文件编辑:美化 package.json、tsconfig.json 等配置
  • 数据分析:查看复杂嵌套的数据结构
  • 日志排查:格式化日志中的 JSON 内容

把粘贴进来的文本交给浏览器原生的 JSON.parse 解析,再用 JSON.stringify 按 2 空格或 4 空格重新输出,另有一个面板给出压缩结果。适合阅读被压成一行的接口返回、在对比配置差异前统一缩进,以及定位某个字符让整段内容无法解析。

输出是重新序列化的结果,不只是调整缩进

格式化实际是两次原生调用:JSON.parse 先构造出一个 JavaScript 值,再由 JSON.stringify(value, null, indent) 写回文本。除了数据本身,你原文里的任何字面量都不会保留,全部由序列化器重写:1.0 变成 1、1e3 变成 1000、25.50 变成 25.5,转义 \u0009 变成 \t。数字在 JS 里是 IEEE-754 双精度浮点,因此 9007199254740993(即 2^53+1)会输出为 9007199254740992;字面量 1e999 解析后是 Infinity,而 JSON 没有对应写法,只能写成 null。重复键在解析阶段就已经被合并,因为一个对象对同一个键只能保存一个值。

「Tab」这一项其实输出的是一个空格

缩进控件是一个数字,直接作为 JSON.stringify 的第三个参数,选项值只有 2、4 和标记为 Tab 的 1。当这个参数是数字时,序列化器会在每层嵌套前重复相应个数的 U+0020,所以值 1 得到的是一个空格,而不是 U+0009;要产出真正的制表符必须传入字符串 "\t",而本组件从不传字符串。数字参数还有两个副作用:数量上限被截到 10,取 0 或负数则完全不换行——压缩面板恰恰就是这样,用不带缩进参数的 JSON.stringify(value) 得到一行结果。

解析器接受、而你的文件里可能不该有的东西

RFC 8259 第 2 节只允许四种空白出现在 token 之间:U+0020、U+0009、U+000A、U+000D。UTF-8 的 BOM(U+FEFF)不在其中,所以「UTF-8 with BOM」保存出来的文件会在第一个字符就报错,报错信息里还会带着一个看不见的字符。注释和尾随逗号同样会被拒绝,尽管 tsconfig.json 这类 JSONC 编辑器接受它们。错误文本来自引擎本身:V8 多数情况下附带一个从 0 开始计数的字符偏移(形如 "in JSON at position 7"),有些输入则改为引用出错片段,所以别期待行列号,要自己从开头数。纯空白的输入按空内容处理,不报错。

实操示例

格式化一条记录,三处值在过程中悄悄变了

输入
{"orderId":9007199254740993,"amount":25.50,"retry":1e999,"status":"paid"}
输出
{
  "orderId": 9007199254740992,
  "amount": 25.5,
  "retry": null,
  "status": "paid"
}

输入 73 字节;两空格格式化后为 6 行、88 字节,压缩面板给出的是 71 字节。orderId 比 2^53-1 大 1,因此被向下取整为 ...992;25.50 重写成 25.5;1e999 溢出成 Infinity,最终写作 null。这三处都不是格式化错误,而是 JavaScript 能表示的数值边界。

边界与常见误用

  • 组件没有实现输入体积上限:整段文本会一次性进入 JSON.parse,随后在主线程做语法高亮,几 MB 的载荷会让页面卡住直到处理结束。
  • 缩进菜单只有 2 空格、4 空格,以及实际插入一个空格的「Tab」项,无法选择真正的制表符或自定义宽度。
  • 只认严格 JSON:注释、尾随逗号、单引号字符串、NaN、Infinity 以及 0x1f 这类十六进制数字都会被拒,带注释的配置需要先清理再粘进来。
  • 重复键在展示之前就被解析器合并,页面上只能看到最后那个值,因此无法用它核查同一对象里重复出现的键。
  • 值要经过双精度浮点往返,18 位长的 ID 或高精度小数在这里无法校验到精确值,此类字段应以字符串形式保存。

相关工具

六种都叫「帮我格式化一下 JSON」的活儿,各自该用什么

你真正要拿到的东西本工具(JSON 格式化)这种情况下更合适的做法
只是想知道手上这段响应长什么样把压缩文本粘进左侧:输出区按 2 空格重新排版,下方压缩面板同时保留紧凑版本,两边一眼对照,而且格式化本身不发任何网络请求。数据还在某个 URL 后面时没必要开页面——curl -s https://api.example.com/orders | jq . 直接打出同样的 2 空格结构,省掉一次复制,请求也留在命令历史里下次接着用。
要给这段数据生成 TypeScript 接口AI 面板会把格式化结果整段当作 prompt 发到本站的 /ai/generate 接口,再把返回内容贴回来;只要解析还报错,按钮就是禁用状态,所以必须先修语法。quicktype 或 json2ts 用同一份 JSON 在本地推导接口(quicktype -l ts payload.json),属性名逐字符照搬。数据不能出本机、或者字段名必须一字不改时,选它们。
只想看大响应里的某一个分支两个面板永远整份渲染:没有路径输入框,没有过滤,没有排序,几千个键的响应进来是什么宽度,出去还是什么宽度。先用 jq '.items[] | select(.stock.qty < 13)' 把范围切小,再决定要不要把这一小段贴进来按 4 空格看。分两步,比在一个巨型对象里滚屏划算。
两份配置要以文本方式比对差异输出顺序取决于解析器交回来的东西:整数样式的键(0、1、2 …)会排到前面并按数值升序,其余键保持插入顺序。格式化只统一缩进,从不改变键序。要的是「内容相同即文本相同」,用 jq -S . 把所有键排序后再输出,diff、git diff 或校验和比的才是内容而不是键的位置。排序交给 jq,人眼阅读再回到本页。
要确认数据对不对,而不只是能不能解析输出干净只说明一件事:JSON.parse 收下了这段文本。缺了必填字段、数字位置放进了字符串、下游认定是数组的地方给的是 null——这些在页面上一样完美。必填与类型这类问题得由 JSON Schema 校验器回答(ajv,或测试里的 schema 断言)。语法错误在这里修,契约问题在那里修,两者的排查路径完全不同。
整个仓库、每次提交都要做同一套清理一次粘贴、一次缩进、一次复制。单个文件这样取舍没问题,但面对一棵目录树就不对了——手工这一步恰恰是缩进在各文件之间飘走的源头。prettier --write "**/*.json" 就地重写整棵树并保持风格一致;把它挂进 pre-commit,就没人需要再粘贴 JSON 了。

一个具体场景

给一份即将提交的响应选定缩进宽度

一份订单响应只有一行:853 字节、8 条记录,最深字段在第 3 层。粘进来后行数不随选项变——1、2、4 空格都是 111 行——字节数却变:1,356、1,689、2,355,因为每行都要按所在层级付一次缩进。2 空格与 4 空格差的 666 字节,就是评审在 diff 里多滚的那一截。文件和 prettier 排好的 JSON 放一起,选 2 空格提交;结果只是贴进工单给人看,就从压缩面板复制,拿回原样的 853 字节。

常见问题

为什么我的 JSON 明明看起来没问题却校验失败?
最常见的原因是:最后一项后面多了逗号、用了单引号而不是双引号、字符串里有未转义的换行,或者包含注释——严格 JSON 不允许这些。校验器会指出确切的行号和列号,先修第一个错误再重新校验,后面的错误往往是第一个错误的连锁反应。
格式化(beautify)和压缩(minify)有什么区别?
格式化添加缩进和换行,让结构易读、便于 diff;压缩去掉所有不必要的空白,用于传输。两者互为无损逆操作,解析结果完全一致。
粘贴包含 token 的 API 响应安全吗?
格式化完全在你的浏览器里用 JavaScript 完成,输入不会发送到任何服务器。但建议保持习惯:在把格式化结果分享到别处之前,先抹掉其中的真实凭证。

内容复核: