标准 json.Marshal 因反射导致性能差,每次调用需动态检查字段、解析 tag、构造字符串并频繁堆分配;推荐用 easyjson 生成专用序列化函数,或 ent/sqlc 替代反射 ORM,极端场景可用 unsafe.Offsetof 手写字段访问。

为什么标准 json.Marshal 走反射就慢
因为每次调用 json.Marshal 都要从头做一遍:检查结构体每个字段是否导出、读取 json: tag、动态构造字段名字符串、反复分配 reflect.Value 和临时 []byte。这些操作无法被编译器内联或消除,且大量触发堆分配——pprof 里常看到 runtime.mallocgc 和 encoding/json.(*encodeState).marshal 占 CPU 前两位。
用 go:generate 生成专用序列化函数
这是最直接有效的方案:把“运行时查字段”变成“编译期写死字段访问”。生成的 MarshalJSON 就是纯结构体字段读取 + strconv 拼接,零 reflect.Value、零 interface{} 断言。
- 在结构体上方加注释:
//easyjson:json或//go:generate easyjson -all user.go - 运行
easyjson -all user.go,生成user_easyjson.go - 调用时直接用
user.MarshalJSON(),不是json.Marshal(user) - CI 中必须校验:加一步
go generate && git diff --quiet || (echo "gen out of date" && exit 1)
字段增删后不重跑 go generate,生成代码就失效——可能 panic 或丢字段,这点极易被忽略。
用 ent 或 sqlc 替代手写反射 ORM
自己写 Insert(struct{}) 并用 reflect.StructField 拼 SQL,等于每条语句都重复解析结构体。ent 和 sqlc 的本质是:读 schema 或 AST,在构建阶段生成固定签名的 CRUD 函数,比如 client.User.Create().SetName("x").SetAge(25).Exec(ctx)。
- ent 要求你定义
ent/schema,生成的是强类型方法链,无反射 - sqlc 从
.sql文件反推 Go 类型,生成的queries.CreateUser(ctx, arg)参数直传,不走interface{} - 别在 ent 生成代码外再包一层泛型 repository——那层抽象必然引入反射和接口逃逸
unsafe.Offsetof 手写字段访问闭包(仅限热路径)
当连 reflect.StructField.Offset 这层封装都觉得重时,可下沉到内存偏移层面。例如预计算 unsafe.Offsetof(User{}.Name),再构造一个闭包:func(u *User) string { return *(*string)(unsafe.Pointer(uintptr(unsafe.Pointer(u)) + offset)) }。
- 只适用于字段稳定、不会加/删/重排的结构体(如 DB 模型)
- 闭包必须接收指针,且确保该类型实例不会被 GC 移动(命名类型安全,但若存于
interface{}中需警惕) - 启用
//go:build !no_unsafe后才生效;字段顺序一变,闭包立即读错内存
这不是通用解法,而是针对明确压测瓶颈点的手术刀式优化,多数项目用不到这一步。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











