直接用结构体指针和预编译编码器、复用 json.Encoder 与缓冲区、绕过反射、避免中间表示、实现 MarshalJSON 接口,可显著提升 JSON 生成效率。

直接用结构体指针和预编译的编码器,跳过反射、复用缓冲区,就能显著提升 JSON 生成效率。关键不是“怎么序列化”,而是“怎么不重复做没必要的事”。
用 json.Encoder 复用底层写入器
每次调用 json.Marshal 都会分配新缓冲区、走完整反射路径;而 json.Encoder 可绑定到 bytes.Buffer 或网络连接,支持多次写入且内部缓存类型信息。
- 初始化一次
encoder := json.NewEncoder(buf),后续用encoder.Encode(v)写入多个值 - 对 HTTP 响应,直接传
w(http.ResponseWriter实现了io.Writer),避免中间拷贝 - 配合
buf.Reset()可循环使用同一缓冲区,减少 GC 压力
提前生成结构体 Schema,绕过运行时反射
标准库 json 包在首次处理某结构体时会构建字段映射表,之后复用;但若结构体类型多、冷启动频繁(如微服务启停),仍会触发重复计算。可手动缓存或使用代码生成。
- 确保结构体类型稳定,字段标签(如
json:"name")固定,Go 运行时会自动缓存其编码器 - 避免在循环中动态构造匿名结构体或使用
map[string]interface{}—— 它们每次都会触发完整反射 - 重度场景可用 easyjson 或 go-json:前者生成专用
MarshalJSON方法,零反射;后者用 unsafe + 类型系统优化,比标准库快 2–5 倍
避免无意义的中间表示,直出流式 JSON
不要先 Marshal 成 []byte,再转 string 或拼接;更不要把 JSON 当字符串解析再改字段——这等于做两次序列化+一次反序列化。
立即学习“go语言免费学习笔记(深入)”;
- 需动态字段?用
map[string]any而非map[string]interface{}(Go 1.18+ 更高效),且尽量控制键数量 - 需部分更新?用
json.RawMessage延迟解析原始字节,仅对变动字段重新编码 - 组合多个对象?用
encoder.Encode连续写入,配合bytes.Buffer的Grow预分配容量,减少扩容拷贝
定制 Marshaler 接口,按需控制输出
对高频结构体,实现 json.Marshaler 接口,手写扁平、确定的编码逻辑,彻底跳过反射和 tag 解析。
- 例如时间字段统一格式:
func (t MyTime) MarshalJSON() ([]byte, error) { return []byte(`"` + t.Time.Format("2006-01-02T15:04:05Z") + `"`), nil } - 敏感字段空值跳过?在
MarshalJSON 中显式判断,不依赖omitempty的反射检查 - 注意:实现该接口后,所有嵌套位置都会调用它,确保逻辑幂等、无副作用










