如何在Golang中使用json.Encoder高效写入JSON

本篇文章给大家分享《如何在Golang中使用json.Encoder高效写入JSON》，覆盖了Golang的常见基础知识，其实一个语言的全部知识点一篇文章是不可能说完的，但希望通过这些问题，让读者对自己的掌握程度有一定的认识(B 数)，从而弥补自己的不足，更好的掌握它。

json.Encoder可高效流式写入JSON数据，适用于文件、网络等场景。①直接编码并写入io.Writer，节省内存；②支持逐个写入多个对象，生成JSON Lines格式；③可用于HTTP响应，避免中间内存分配；④通过SetIndent控制输出格式，提升可读性。核心优势在于边编码边写入，减少内存拷贝，提升性能。

在Go语言中，json.Encoder 是处理JSON写入操作的高效工具，特别适用于需要将数据流式写入文件、网络连接或缓冲区的场景。相比 json.Marshal 先生成完整字节再写入的方式，json.Encoder 可以直接将结构体编码并写入目标 io.Writer，节省内存并提升性能。

使用 json.Encoder 写入文件

当你需要将多个JSON对象逐个写入文件时，json.Encoder 非常适合。它可以直接与 *os.File 结合使用。

将一个结构体写入 JSON 文件：

package main

import (
    "encoding/json"
    "os"
)

type User struct {
    ID   int    `json:"id"`
    Name string `json:"name"`
}

func main() {
    file, _ := os.Create("user.json")
    defer file.Close()

    encoder := json.NewEncoder(file)
    user := User{ID: 1, Name: "Alice"}

    encoder.Encode(user) // 直接写入文件
}

执行后，user.json 中会包含一行格式化的 JSON 数据（结尾有换行）。

流式写入多个JSON对象

在日志处理、数据导出等场景中，你可能需要将大量对象逐个写入同一个文件，每个对象占一行。此时 json.Encoder 的流式特性非常有用。

例如，导出用户列表：

users := []User{
    {ID: 1, Name: "Alice"},
    {ID: 2, Name: "Bob"},
    {ID: 3, Name: "Charlie"},
}

file, _ := os.Create("users.jsonl")
defer file.Close()

encoder := json.NewEncoder(file)
for _, user := range users {
    encoder.Encode(user) // 每次调用写入一行
}

输出为 JSON Lines 格式（每行一个独立JSON），便于后续逐行读取处理。

写入HTTP响应或网络流

在Web服务中，若需返回JSON数据，可直接用 json.Encoder 写入 http.ResponseWriter，避免中间内存分配。

func handler(w http.ResponseWriter, r *http.Request) {
    w.Header().Set("Content-Type", "application/json")

    user := User{ID: 1, Name: "Alice"}
    encoder := json.NewEncoder(w)
    encoder.Encode(user) // 直接写入响应流
}

这种方式比先 json.Marshal 再 w.Write 更高效，尤其在返回大数据时。

控制编码格式（如美化输出）

默认情况下，json.Encoder 输出紧凑格式。如需美化输出（带缩进），可先设置格式化选项。

虽然 json.Encoder 本身不支持直接设置缩进，但可以通过包装 io.Writer 实现：

import "bytes"

var buf bytes.Buffer
encoder := json.NewEncoder(&buf)
encoder.SetIndent("", "  ") // 设置缩进

user := User{ID: 1, Name: "Alice"}
encoder.Encode(user)

os.Stdout.Write(buf.Bytes())

注意：SetIndent 会影响后续所有 Encode 调用的输出格式。

基本上就这些。合理使用 json.Encoder 能显著提升I/O密集型JSON写入的效率，特别是在处理大对象或流式数据时。关键是理解它“边编码边写入”的机制，避免不必要的内存拷贝。

本篇关于《如何在Golang中使用json.Encoder高效写入JSON》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于Golang的相关知识，请关注golang学习网公众号！