Go 怎样压缩 JSON 并保留字符串内容

Go 里压缩一段 JSON，直接使用 encoding/json 的 json.Compact：它把 JSON 结构中的无意义空格、换行和制表符去掉，并把结果追加到 bytes.Buffer。字符串值内部的空格不会被当成格式空白删除；如果输入不是合法 JSON，则保留错误并停止把缓冲区内容交给下游。

官方地址：https://pkg.go.dev/encoding/json

用 bytes.Buffer 接收压缩结果

Compact 的参数不是返回新的字节切片，而是接收一个目标缓冲区，再读取源字节。这个设计适合把压缩结果继续写入请求体、缓存或文件。下面的示例只关注压缩边界，代码没有依赖业务结构体。

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
)

func compactJSON(src []byte) ([]byte, error) {
    var dst bytes.Buffer
    // Compact 只移除 JSON 结构空白，不改写字符串值。
    if err := json.Compact(&dst, src); err != nil {
        // 输入非法时把语法错误交给调用方，避免消费不完整结果。
        return nil, fmt.Errorf("压缩 JSON: %w", err)
    }
    // Bytes 返回当前缓冲区内容；调用方可复制后长期保存。
    return dst.Bytes(), nil
}

这里的 dst 是局部缓冲区，函数成功时返回它的字节内容；如果需要跨越缓冲区生命周期保存，可以在调用方使用 bytes.Clone。不要把一个会继续写入的 Buffer 的内部切片当成稳定快照。

压缩只针对结构空白，不改字符串语义

JSON 里的空白并不都具有同一种意义。对象键和值之间的空格、逗号后的换行属于格式排版；而字符串字面量中的空格属于数据。例如 "Go 教程" 中间的空格必须保留，字符串里的换行通常以 \n 形式存在，也不能被当成排版换行处理。

func exampleInput() []byte {
    // 结构换行和缩进可以压缩，字符串中的空格属于业务内容。
    return []byte(`{
        "title": "Go 教程",
        "note": "保留  字符串  中的空格",
        "items": [1, 2, 3]
    }`)
}

json.Compact 不是通用文本去空格工具，它会按 JSON 语法识别字符串、数字、对象和数组。也因此，不能用 strings.ReplaceAll 粗暴删除空格：那样会破坏字符串内容，甚至把转义边界弄乱。

非法 JSON 要把错误留在边界内

Compact 返回 error，意味着压缩动作同时承担了输入语法检查。少一个引号、数组逗号多写一个，或者对象结构没有闭合，都应进入错误分支。生产代码里应先记录或包装错误，再决定返回 400、丢弃消息，还是交给重试队列；不要只因为 Buffer 里已经有部分内容就继续解析。

func safeCompact(src []byte) ([]byte, error) {
    var dst bytes.Buffer
    // 先建立压缩结果，目标缓冲区只服务于这一次输入。
    if err := json.Compact(&dst, src); err != nil {
        // 错误路径不暴露可能不完整的字节，调用方只能处理明确失败。
        return nil, err
    }
    return bytes.Clone(dst.Bytes()), nil
}

如果上游已经有独立的合法性判断，可以先用 json.Valid 做快速分支，但通常没有必要为了同一份输入重复扫描；直接调用 Compact 并处理它的错误即可。是否清空复用的 Buffer，要根据调用方是否还需要旧内容来决定，避免把两次请求的结果拼在一起。

按用途选择 JSON 的三种处理方式

如果输入是可信的 JSON 文本而任务只是去掉排版空白，优先使用 Compact，这样不会把数字、键顺序或字符串重新转换成另一种表示。若你需要校正字段类型、过滤未知字段或改变编码策略，应先解码再重新编码，那已经超出了“只压缩空白”的边界。

发布前的压缩检查清单

• 目标缓冲区是否只对应当前输入，没有残留上一次请求的内容？
• 错误是否被返回或包装，下游是否只消费成功结果？
• 示例中的字符串空格、转义换行是否被视为数据而非排版？
• 是否把 Compact 与 Marshal 的用途区分开了？
• 如果返回的字节需要长期保存，是否复制了 Buffer 的内容？

相关问题

json.Compact 会删除字符串里的空格吗？

不会。它删除的是 JSON 结构中的无意义空白，字符串字面量内部的字符仍属于数据。

压缩失败时能继续使用 bytes.Buffer 吗？

不建议。错误表示输入没有完成合法的 JSON 压缩，调用方应丢弃这次结果并按业务规则处理错误。

已经有 Go 结构体时还需要 Compact 吗？

通常不需要。结构体应直接用 json.Marshal 生成紧凑 JSON；Compact 更适合处理已经存在的 JSON 字节。