Golang高效写入JSON方法解析

本文深入解析了Go语言中高效写入JSON的核心工具——json.Encoder，强调其“边编码边写入”的流式处理机制如何显著减少内存占用、避免中间字节切片分配，并大幅提升I/O密集型场景下的性能；无论是将结构体直接写入文件、生成便于解析的JSON Lines日志、实时响应HTTP请求，还是通过SetIndent实现格式化输出，json.Encoder都展现出比json.Marshal更优的工程实践价值，是Go开发者处理大规模或流式JSON数据时不可或缺的高性能选择。

在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方法解析》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多Golang知识！