JSON 压缩工具

去除 JSON 中的空白字符,使其体积尽可能小。

所有处理均在您的浏览器中完成。您粘贴的内容不会被上传或保存。

深度指南

JSON 压缩:删掉什么、改写什么、能省多少

压缩工具如何把 JSON 重新序列化为无空白的一行,过程中哪些字符和数字会被改写,实际能省多少体积,以及压缩并非逐字节安全的情形。

最后核实: 本指南的纯文本版

关键数字一览

方法
先 JSON.parse,再不带缩进地 JSON.stringify
是对值的重写,而不是用正则去掉空格。
运行时机
每次输入或粘贴时
没有“压缩”按钮;输出框随输入实时更新。
典型节省
2 个空格缩进约省 42%,4 个空格缩进约省 55%
基于下面 100 条记录的示例测得;嵌套越深省得越多,密集的数字数组省得较少。
字符串内的空白
原样保留
只删除标记之间的空白。

工具做了什么

粘贴 JSON 后,右侧输出框立即显示单行版本。页面内部对输入执行 JSON.parse,再对结果执行不带缩进参数的 JSON.stringify。如果文本不是有效的 JSON,输出保持为空并以红字显示错误;工具不会猜测或修复。输入为空时全部清空。复制按钮复制输出内容(按钮文字会短暂变成“已复制”);此页面没有下载按钮。

RFC 8259 允许在六个结构字符和值的周围出现无意义的空白(空格、制表符、换行、回车)。删除它们不会改变数据模型,因此压缩前后的 JSON 对解析器来说是等价的。

示例

输入(186 个 UTF-8 字节):

{
    "name": "Mei Tan",
    "city": "Singapore",
    "scores": [
        90,
        85.50,
        1e2
    ],
    "note": "a  b\/c é 中",
    "active": true,
    "spouse": null
}

输出(111 字节,省 75 字节,即 40.3%):

{"name":"Mei Tan","city":"Singapore","scores":[90,85.5,100],"note":"a  b/c é 中","active":true,"spouse":null}

请注意其他变化:85.50 变成 85.5,1e2 变成 100,\/ 变成 /,é 变成 é。而 "a b" 里的两个空格被保留。

能省多少

节省量取决于缩进和嵌套。以下是 100 条小记录(id、name、city、含两项的 tags 数组、active)组成的数组:

源格式 字节数 压缩后字节数 节省
2 个空格缩进 13,236 7,735 41.6%
4 个空格缩进 17,236 7,735 55.1%

经过大多数网络服务器都会启用的 gzip 之后,差距会大幅缩小:2 个空格版本为 664 字节,压缩版本为 597 字节,因为重复的空白本来就很容易被压缩。压缩 JSON 适合存储和日志;如果响应已被压缩传输,别指望传输量能省很多。

压缩后并非逐字节相同的情形

  • 数字 会经过 JavaScript 双精度重新输出。12345678901234567890 变成 12345678901234567000,1e400 变成 null。
  • 重复键 只保留最后一个,"2" 这类整数形式的键会排到其他键前面。
  • 转义会被解码:</script> 会输出成字面文本 </script>。如果你把压缩后的 JSON 嵌入 HTML 的 <script> 块,这段字面文本可能提前结束该块,所以请在构建步骤里重新转义 <。
  • 行分隔符:U+2028 和 U+2029 会以原始字符输出,ES2019 及之后允许它们出现在字符串内。
  • 不是 JSON 就无法压缩:注释、末尾逗号和单引号会使解析失败。这是 JSON 压缩工具,不是 JavaScript 压缩工具。

提示: 如果下游系统要对文档的精确字节做签名或哈希,请只压缩一次,保存这个结果,并对保存的副本签名。日后用别的工具再压缩,键顺序或数字写法可能不同。

常见错误

  • 以为字符串里的文字也会被压缩:"a b" 的两个空格会保留,字符串里的 \n 仍是转义序列。
  • 压缩含 19 位 ID 的文档后,发现末几位变了。
  • 以为压缩后的文件已被加密或混淆;它只是同样的数据,可以立即重新格式化。
  • 寻找下载按钮;请改用复制,或使用可下载的 JSON 格式化页面。

相关工具

用 JSON 格式化重新美化,用 JSON 验证器检查语法,用 JSON 查看器浏览结构,或用 JSON 转 CSV转换记录。处理普通文本时,文本压缩工具无需解析即可去除空白。

常见问题

压缩 JSON 能缩小多少?

它只去掉标记之间的空白,所以节省多少取决于原文件缩进的多少。数据本身不会改变。

我的 JSON 会被发送到服务器吗?

不会。一切都在您的浏览器中完成。您粘贴的内容不会被上传、记录或存储——当文档中包含密钥、令牌或个人数据时,这一点尤为重要。

为什么提示我的 JSON 无效?

最常见的原因是多余的尾随逗号、键和字符串使用了单引号而非双引号,以及字符串内部存在未转义的换行。错误信息会给出首个问题的行号和列号。

它会改动我的数据吗?

不会。文档会被解析并重新序列化,因此只有空白字符发生变化。键的顺序保持不变,值也不会被改动。

能处理大型文档吗?

可以,只要在浏览器内存允许的范围内。几兆字节的文档没有问题;极大的文件在解析时可能会让页面短暂停顿。

资料来源

  1. IETF — RFC 8259, The JSON Data Interchange Format — Insignificant whitespace, string escapes and number interoperability.
  2. MDN — JSON.stringify()

本指南用浅白语言解释已公布的规则,不构成财务、法律或官方意见。政策会变动,做决定前请向上方链接的政府机构核实。

相关工具

把这个工具嵌入你的网站

免费使用。把这段代码贴到你的网页,并保留指向 ToolSG 的链接。