json.Encoder适合流式写入场景，如HTTP响应或文件输出，相比json.Marshal更节省内存；通过实例演示了其基本用法、格式化输出、批量写入JSON流及Web服务中的应用。
在Go语言开发中，处理JSON数据是常见需求，特别是在构建Web服务或进行数据交换时。json.Encoder 是标准库 encoding/json 中的重要组件，相比直接使用 json.Marshal，它更适合流式写入场景，比如将结构体编码后直接输出到HTTP响应体或文件中。本文介绍 json.Encoder 的基本用法、常用技巧和实际应用场景。
json.Encoder 与 json.Marshal 的区别
两者都能将Go值编码为JSON格式，但适用场景不同：
- json.Marshal：返回一个字节切片（[]byte），适合小数据量、需要中间处理的场景。
- json.Encoder：直接写入 io.Writer，适合大对象、流式输出或持续写入的场景，如HTTP响应、日志写入等，节省内存。
例如，在HTTP处理器中，不需要先把数据序列化成字节再写入响应，可以直接用 Encoder 边编码边输出。
基本使用方法
创建一个 json.Encoder 需要一个实现了 io.Writer 接口的对象，比如 *os.File、*bytes.Buffer 或 http.ResponseWriter。
立即学习“go语言免费学习笔记（深入）”；
package main
import (
"encoding/json"
"log"
"os"
)
type User struct {
Name string `json:"name"`
Age int `json:"age"`
Email string `json:"email,omitempty"`
}
func main() {
user := User{Name: "Alice", Age: 30, Email: "alice@example.com"}
// 创建Encoder，写入标准输出
encoder := json.NewEncoder(os.Stdout)
if err := encoder.Encode(user); err != nil {
log.Fatal(err)
}
// 输出：{"name":"Alice","age":30,"email":"alice@example.com"}
}
注意：Encode() 方法会自动添加换行符，适合逐条记录输出，比如日志流。
格式化输出与自定义设置
默认情况下，json.Encoder 输出紧凑格式。若需美化输出（带缩进），可配合 SetIndent 方法：
encoder := json.NewEncoder(os.Stdout)
encoder.SetIndent("", " ") // 使用两个空格缩进
err := encoder.Encode(user)
输出结果会变成：
{
"name": "Alice",
"age": 30,
"email": "alice@example.com"
}
这个功能在调试或生成可读配置文件时非常有用。
批量写入JSON流
当处理大量数据时，比如导出用户列表，使用 json.Encoder 可以避免一次性加载所有数据到内存。
示例：逐个写入用户记录，形成JSON数组流：
users := []User{
{Name: "Alice", Age: 30},
{Name: "Bob", Age: 25},
{Name: "Charlie", Age: 35},
}
file, _ := os.Create("users.json")
defer file.Close()
// 先写左方括号
file.WriteString("[\n")
encoder := json.NewEncoder(file)
for i, user := range users {
encoder.SetIndent("", " ")
encoder.Encode(&user)
if i < len(users)-1 {
file.WriteString(",\n")
} else {
file.WriteString("\n")
}
}
file.WriteString("]\n")
这种方式适用于大数据导出，内存占用低，适合定时任务或日志归档。
结合HTTP响应输出JSON
在Web服务中，json.Encoder 常用于直接向客户端返回JSON数据：
func handler(w http.ResponseWriter, r *http.Request) {
user := User{Name: "Alice", Age: 30}
w.Header().Set("Content-Type", "application/json")
encoder := json.NewEncoder(w)
encoder.Encode(user) // 直接写入响应流
}
这样做比先 Marshal 再 Write 更高效，尤其在返回大型结构时。
基本上就这些。json.Encoder 简单高效，适合大多数需要直接输出JSON的场景，掌握它能让你的Go程序更优雅地处理数据流。
