JSONC解压不迷路：decompress与unpack用法及常见踩坑指南

JSONC解压不迷路：decompress与unpack用法及常见踩坑指南

【免费下载链接】JSONCJSON compressor and decompressor项目地址: https://gitcode.com/gh_mirrors/json/JSONC

在Web开发中，前后端之间传输大体积JSON数据是性能瓶颈的重灾区。JSONC正是一个专为JSON压缩解压而生的开源JavaScript库，它提供两套互补的方案：compress/decompress（键名映射压缩与解压）和pack/unpack（Gzip+Base64压缩与解压）。很多新手在JSONC解压时总把decompress与unpack搞混，导致数据还原失败。这篇文章将用最通俗的方式讲清JSONC解压的decompress与unpack用法、两者的本质区别，并梳理JSONC解压时最常见的几个踩坑点，帮你一次用对。

认识JSONC：为什么需要JSON压缩解压库

富互联网应用（RIA）中，服务器下发的数据可以用GZIP压缩，但从浏览器向服务器上传大量数据时，普通的GZIP并不总能生效。JSONC正是为这个场景设计：它在浏览器端先把JSON压缩再传输，从而显著减少流量。

JSONC提供了两种截然不同的压缩解压思路：

• compress / decompress：把JSON对象中冗长的键名映射成单个字符（A、B、C…），用"键值字典"换空间，适合字段重复多的大数据。
• pack / unpack：把JSON序列化成字符串后，用GZIP压缩，再Base64编码，避免URL编码导致体积反弹，适合任意JSON对象。

官方基准测试显示，JSONC整体压缩率最高可达75.49%。下图直观展示了不同方案的发送/接收体积对比，其中pack gzip with base64方案表现最佳，改进幅度达到67.11%。

核心概念：decompress与unpack到底有什么区别

一句话记住：decompress解的是compress压缩后的JSON对象；unpack解的是pack压缩后的Gzip字符串。两者针对的数据形态完全不同。

对照源码可以看得更清楚：decompress的实现位于 src/JSONC.js，unpack则位于 src/JSONC.js。

JSONC decompress用法：一键还原被压缩的JSON对象

使用场景：你（或服务端）用JSONC.compress压缩过数据，现在需要还原。压缩与解压是天生的一对，用法如下：

var compressed = JSONC.compress( json ); // 压缩 var restored = JSONC.decompress( compressed ); // 解压，还原原始JSON

压缩后的对象会多出一个_字段，它就是键名映射字典；decompress正是依据这张字典把 A、B、C 还原回原始键名。该逻辑同样支持数组与多层嵌套对象，完整边界场景可以参考 test/JSONC.js 中的Jasmine测试用例。

JSONC unpack用法：解开Gzip+Base64压缩字符串

使用场景：你拿到的是JSONC.pack产生的字符串（Gzip+Base64），通常来自网络传输或服务端返回。基本用法：

var packed = JSONC.pack( json ); // 普通JSON → Gzip字符串 var json = JSONC.unpack( packed ); // 还原为原始JSON对象

如果打包时传入了true（即先compress再pack），那么解压时也必须传入true，两步都要还原：

var packed = JSONC.pack( json, true ); // 先压缩键名，再Gzip var json = JSONC.unpack( packed, true ); // 先解Gzip，再还原键名

服务端如需在PHP中解压，可以直接使用项目自带的 php/GzipJSON.php，它实现了对Gzip字符串的inflate解压逻辑，与前端unpack天然对接。

JSONC解压常见踩坑清单：这5个坑千万别踩

坑1：把decompress拿去解"没压缩过"的JSON

decompress依赖压缩数据中的_字段作为键名映射，如果传入的是普通JSON，代码读取_时会直接抛异常。务必记住：只有compress出来的对象才能用decompress还原。

坑2：pack与unpack参数不对称

pack(json, true)压缩出来的字符串，必须用unpack(str, true)解压；反之pack(json)就对应unpack(str)。参数不一致时虽然不会报错，但键名不会被还原，解出来是"A、B、C"而不是原始字段名。

坑3：小数据压缩后反而变大

compress的键名映射会附带一张字典（_字段），数据量很小时字典开销可能超过节省的字节，导致压缩后体积更大。建议只对字段重复多、体积大的JSON使用；小对象直接用pack或原样传输即可。

坑4：忽略Base64导致URL编码增重

早期版本直接输出Gzip字符串，经POST传输时会被URL编码，体积反而膨胀（实测最高增重约36%）。现在pack输出的一律是Base64字符串，直接交给unpack处理即可，不要手动二次转码。

坑5：业务数据里出现_保留键

_是JSONC的保留键，专门存放键名映射字典。如果业务数据本身有_字段，压缩解压时可能被当作字典处理，导致数据错乱，字段命名时尽量避开。

如何快速上手JSONC：获取、引入与验证

获取源码并引入浏览器端压缩版本即可开始使用：

git clone https://gitcode.com/gh_mirrors/json/JSONC

• 生产环境可直接引入压缩版：versions/jsonc.min.js，仓库还提供了sourcemap便于排查问题；
• 想阅读源码或二次开发，看 src/JSONC.js，四个核心方法都在此文件内；
• 想验证行为，直接跑 test/JSONC.js 中的测试，decompress与unpack的各种边界情况都有覆盖。

结语

JSONC解压并不复杂，核心就是记住一条规则：compress配decompress，pack配unpack；打包传了true，解压也要传true。理清decompress与unpack用法，避开上述几个常见踩坑点，你就能用JSONC轻松为前后端数据瘦身，让每一次数据传输都快人一步。🚀

【免费下载链接】JSONCJSON compressor and decompressor项目地址: https://gitcode.com/gh_mirrors/json/JSONC