Go语言JSON序列化与反序列化区别详解

本文深入解析了Go语言中JSON序列化与反序列化的两大核心范式——`json.Marshal/Unmarshal` 与 `json.NewEncoder/NewDecoder` 的本质区别：前者面向内存字节切片（`[]byte`），轻量简洁，适合配置解析、小数据API响应等场景；后者面向流式I/O（`io.Reader`/`io.Writer`），支持零拷贝写入、缓冲复用和持续数据处理，是构建高性能REST API、处理大体积或流式JSON（如NDJSON日志）的首选。二者底层逻辑一致，实为同一能力在不同抽象层级的封装，关键选择依据在于数据形态——“内存用Marshal，流用Encode”，掌握这一原则能显著提升代码效率、可维护性与系统吞吐表现。

在Go中，“marshalling/unmarshalling”与“encoding/decoding”均用于JSON数据转换，但语义和使用场景不同：前者面向内存中的字节切片（[]byte），后者面向流式I/O（如io.Reader/io.Writer），二者底层逻辑相通但抽象层级有别。

在Go中，“marshalling/unmarshalling”与“encoding/decoding”均用于JSON数据转换，但语义和使用场景不同：前者面向内存中的字节切片（`[]byte`），后者面向流式I/O（如`io.Reader`/`io.Writer`），二者底层逻辑相通但抽象层级有别。

Go标准库的encoding/json包提供了两组核心API，常被初学者混淆：

• json.Marshal() / json.Unmarshal()：处理内存内数据。
  Marshal(v interface{}) ([]byte, error) 将Go值序列化为JSON格式的字节切片；
  Unmarshal(data []byte, v interface{}) error 则将JSON字节切片反序列化为Go结构体。适用于已知完整数据、无需流式处理的场景（如API响应构造、配置解析）。

• json.NewEncoder(w io.Writer) / json.NewDecoder(r io.Reader)：处理流式I/O。
  Encoder.Encode(v interface{}) error 将Go值直接写入任意io.Writer（如HTTP响应体、文件、网络连接）；
  Decoder.Decode(v interface{}) error 从io.Reader（如HTTP请求体、文件）中按需读取并解析JSON。适用于高吞吐、大体积或持续数据流场景（如RESTful API的请求/响应处理、日志流解析）。

以下示例对比二者用法：

type Person struct {
    First string `json:"first"`
    Last  string `json:"last"`
}

func main() {
    p := Person{"Alice", "Bob"}

    // ✅ Marshal/Unmarshal：操作 []byte
    bs, _ := json.Marshal(p)
    fmt.Println("Marshalled:", string(bs)) // {"first":"Alice","last":"Bob"}

    var p2 Person
    json.Unmarshal(bs, &p2)
    fmt.Println("Unmarshalled:", p2)

    // ✅ Encode/Decode：操作 io.Writer/io.Reader（以 bytes.Buffer 模拟流）
    var buf bytes.Buffer
    enc := json.NewEncoder(&buf)
    enc.Encode(p) // 直接写入 buffer，无需中间 []byte
    fmt.Println("Encoded:", buf.String())

    dec := json.NewDecoder(&buf)
    var p3 Person
    dec.Decode(&p3) // 直接从 buffer 读取
    fmt.Println("Decoded:", p3)
}

⚠️ 注意事项：

• Marshal/Unmarshal 更轻量、易测试，适合小到中等数据；但若反复处理大量JSON，频繁分配[]byte可能增加GC压力。
• Encoder/Decoder 支持流式处理（如逐行解析NDJSON）、复用缓冲区、与HTTP handler天然契合（http.ResponseWriter实现了io.Writer），是构建高性能REST API的推荐方式。
• Encoder内部仍调用Marshal，Decoder也依赖Unmarshal逻辑，二者并非互斥，而是同一能力在不同抽象层的封装——选择依据是数据来源/去向：内存字节？还是IO流？

总结：不必纠结术语差异，牢记口诀——“内存用Marshal，流用Encode”。在Web开发中，json.NewEncoder(w).Encode(resp) 应作为HTTP响应的默认写法；而json.Unmarshal(reqBody, &req) 是解析请求体的标准实践。

终于介绍完啦！小伙伴们，这篇关于《Go语言JSON序列化与反序列化区别详解》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布Golang相关知识，快来关注吧！