Go json.Compact 怎样压缩 JSON 字节而不改变内容

在 Go 里，如果手上已经有一段合法 JSON 字节，只想去掉对象、数组和字段之间的格式化空白，可以使用 encoding/json.Compact。它把紧凑后的内容追加到 bytes.Buffer，不会把字符串值里的空格当成格式空白删除；输入不合法时返回错误，调用方必须检查这个 error。

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

这次我把它当作“JSON 字节整理”来处理，而不是压缩算法：它不负责 gzip、zstd 之类的传输压缩，也不会把 JSON 重新转换成另一种数据模型。

json.Compact 删除的到底是哪类空白

JSON 的结构符号周围可以出现空格、制表符、换行和回车。Compact 会删除这些不影响 JSON 语义的空白，让多行格式变成更紧凑的字节序列。

但字符串字面量是内容的一部分。例如 "hello world" 中间的空格不能被删掉，字符串中的转义符也必须保持原本的语义。判断“能不能删”的依据是 JSON 语法状态，而不是简单地对字节做全局替换。

最小调用方式是把结果追加到 bytes.Buffer

函数签名是 json.Compact(dst *bytes.Buffer, src []byte) error。目标不是返回一份新的字节切片，而是把处理后的 JSON 写进传入的缓冲区，因此缓冲区中原有内容会成为结果前缀。

package main

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

func main() {
    src := []byte(`{
        "name": "Go",
        "message": "hello world"
    }`)

    var dst bytes.Buffer
    // 先放入前缀，说明 Compact 的写入方式是追加而不是覆盖。
    dst.WriteString("payload=")
    // 只删除 JSON 结构中的无意义空白，字符串里的空格仍属于内容。
    if err := json.Compact(&dst, src); err != nil {
        // 输入不是合法 JSON 时，把错误交给调用方，不把半成品当成功结果。
        panic(err)
    }
    // 读取缓冲区中的完整结果，前缀和紧凑 JSON 会连在一起。
    fmt.Println(dst.String())
}

这个例子得到的内容形态是 payload={"name":"Go","message":"hello world"}。示例中的字符串空格保留，字段之间的换行和缩进消失。生产代码不应依赖某一次打印结果来判断成功，而应以返回的 error 为准。

输入不合法时为什么必须检查 error

Compact 会按 JSON 语法扫描输入。少一个引号、括号没有闭合、字段之间缺少必要分隔符时，输入就不是可供压缩的合法 JSON。此时返回的错误通常是语法错误，调用方应该停止使用这次结果。

有一个容易忽略的边界：因为函数会向目标缓冲区追加，所以目标里原本已经存在的前缀属于调用方自己的内容。发生错误时，不能把“缓冲区里还有前缀”误判为“压缩成功”。

func compactPayload(src []byte) (string, error) {
    var dst bytes.Buffer
    // 业务前缀是目标缓冲区的既有内容，不是 JSON 输入的一部分。
    dst.WriteString("body=")

    // Compact 会校验 JSON；错误时返回原始错误并放弃当前结果。
    if err := json.Compact(&dst, src); err != nil {
        return "", fmt.Errorf("compact json: %w", err)
    }
    // 只有没有错误时，才把追加后的缓冲区交给后续逻辑。
    return dst.String(), nil
}

Compact 不等于 gzip，也不是任意文本压缩

json.Compact 只处理 JSON 的表现形式：它让同一份 JSON 少占一些格式空白。它不会降低字段名、数字或字符串本身的编码成本，也不会输出压缩二进制格式。

如果目标是 HTTP 传输体积，还需要在 JSON 紧凑化之后选择 gzip、zstd 等传输层方案，并由客户端按对应协议解压。不要把“JSON 没有换行了”和“网络已经启用压缩”混为一谈。

什么时候应该换用 Indent 或 Marshal

写在最后

使用 json.Compact 时记住三件事：它删除的是 JSON 结构空白，不是字符串内容；它把结果追加到 bytes.Buffer，不是覆盖目标；它返回 error，错误输入不能继续向下游传递。掌握这三个边界，压缩 JSON 字节就不会和字符串替换、格式化输出或网络压缩混在一起。

相关问题

• json.Compact 会改变字符串里的空格吗？不会，字符串字面量中的空格属于 JSON 内容。
• 目标 bytes.Buffer 里已有内容会被清空吗？不会，Compact 按追加语义写入目标。
• 输入 JSON 不完整时能否继续使用输出？不能，应先处理返回的错误。
• Compact 能替代 gzip 吗？不能，Compact 只去掉 JSON 格式空白。