如何将 JSON 转为紧凑文本

概述与适用场景

这个工具用于把符合条件的 JSON 解析后重新序列化为紧凑文本，适合整理配置、接口示例或需要减少格式空白的 JSON。它不是二进制压缩工具，也不是简单地逐个删除空格：处理结果取决于 JSON 解析和紧凑序列化。输入可以是 JSON 文本，也可以留空；空文本或只含空白字符的输入会走单独的成功分支。

操作步骤：将 JSON 转为紧凑文本

1. 准备一段 JSON 文本。确认它是非空白的有效 JSON，并注意输入的 UTF-8 编码不能超过 1,000,000 字节。对象、数组、字符串、数字、布尔值和 null 都应遵循 JSON 语法。
2. 将 JSON 粘贴到工具的文本输入区域。输入是可选的；如果暂时不提供内容，可以直接保留空白。
3. 执行处理。对于符合大小限制的有效 JSON，工具会先解析内容，再输出不在逗号和冒号后添加空格的紧凑 JSON 文本。非 ASCII 字符不会被强制改写成 ASCII 转义序列。
4. 查看结果。非空输入成功时，比较输入和输出的字符数，并查看节省量和按一位小数显示的节省百分比。若输入无效、不是字符串，或超过适用的字节限制，应先修正输入后再处理。

如何理解处理结果

成功结果表示文本已通过 JSON 解析并完成紧凑序列化，不表示内容经过二进制压缩。对于非空输入，输入和输出大小按字符数统计；节省量不会显示为负数，节省百分比按一位小数四舍五入。输出不一定比输入短，例如原文本本来就很紧凑时，节省量可能为零。

空文本或只含空白字符时，结果为空，并且大小与节省统计均为零。非空白的无效 JSON 会失败，并提供检测到的行和列位置；超过 1,000,000 字节的非空白输入会在解析前被拒绝。需要留意，空白输入的特殊处理发生在大小检查之前。

使用示例

你要整理一段带有中文名称和数组字段的 JSON 配置，并希望在保留 JSON 数据结构的情况下查看格式化前后的大小变化。

把包含中文字符的 JSON 文本粘贴到输入区域并执行处理，然后检查输出文本是否采用紧凑格式，并查看结果中的大小统计。

结果应包含紧凑 JSON 文本、成功状态，以及输入和输出大小、节省量和节省百分比等统计信息；具体数值取决于实际处理结果。

使用限制

• 无效 JSON、非字符串输入和超过适用字节限制的非空白输入不会成功处理；结果中的大小按字符数统计，因此字节上限与字符数并非同一指标。

常见错误

• 原因：输入包含不符合 JSON 语法的内容，例如缺少逗号或引号。改正：根据结果提供的行、列位置检查标点、字符串引号及括号配对，再重新提交。

常见问题

这个工具能把 JSON 变小吗？

可以，但前提是输入是非空白的有效 JSON，并且 UTF-8 编码不超过 1,000,000 字节。处理过程是解析后重新序列化，而不是只删除空格。

不输入内容会发生什么？

可以。空文本或只含空白字符时，工具会将其视为有效的特殊情况，并返回空结果以及为零的大小和节省统计。

JSON 格式错误时会显示什么？

会失败，并在结果中提供检测到的行和列位置。应先修正 JSON 语法，再重新处理。