Go 的 encoding/gob 是专为 Go 类型设计的原生二进制序列化方案,高效安全、无需额外 schema,适用于进程间通信、缓存和持久化;要求结构体字段可导出、类型可编码,支持文件和网络传输,但不兼容其他语言且需注意版本兼容性与并发安全。

Go 的 encoding/gob 是 Go 原生二进制序列化方案,专为 Go 类型设计,高效、安全、无需额外 schema,适合进程间通信、缓存、持久化等场景。
gob 序列化的基本流程
gob 要求数据结构是可导出的(首字母大写),且字段类型需支持 gob 编码(如基本类型、切片、map、结构体、指针等)。不支持函数、channel、未导出字段、含不可编码字段的嵌套结构。
- 定义结构体:确保字段名大写(可导出),如
type User struct { Name string; Age int } - 创建编码器:用
gob.NewEncoder(w io.Writer),w可以是文件、网络连接或bytes.Buffer - 调用
Encode(v interface{}) error写入数据 - 解码时用
gob.NewDecoder(r io.Reader),再调用Decode(&v),注意传入变量地址
保存到文件和从文件读取
使用 os.Create 和 os.Open 配合 gob 编解码,是最常见的持久化方式。注意错误检查和资源关闭。
- 写入文件:
f, _ := os.Create("data.gob"); defer f.Close(); enc := gob.NewEncoder(f); enc.Encode(user) - 读取文件:
f, _ := os.Open("data.gob"); defer f.Close(); dec := gob.NewDecoder(f); var u User; dec.Decode(&u) - 建议在 encode/decode 前先注册自定义类型(尤其跨版本或含接口时):
gob.Register(User{})
通过网络传输 gob 数据
gob 天然适配 net.Conn,常用于 RPC 或微服务内部通信。发送端 encode,接收端 decode,双方需使用相同结构体定义。
立即学习“go语言免费学习笔记(深入)”;
- 服务端监听并解码:
conn, _ := listener.Accept(); dec := gob.NewDecoder(conn); dec.Decode(&req) - 客户端编码发送:
enc := gob.NewEncoder(conn); enc.Encode(req) - 注意:gob 不自带消息边界,TCP 流中需自行处理分帧(例如每次 encode 后 flush,或封装长度头)
- 若需多路请求响应,推荐搭配
net/rpc包,它底层就基于 gob
注意事项与常见陷阱
gob 不是通用格式,不能被其他语言直接解析;它的兼容性依赖 Go 版本和结构体定义稳定性。
- 结构体字段增删可能破坏兼容性:新增字段默认零值,删除字段会导致 decode 失败(除非用
gob.RegisterName或版本控制) - 时间类型
time.Time、空接口interface{}可编码,但需确保运行时类型已注册(如gob.Register(time.Time{})) - 避免对 map/slice 指针直接 encode;应 encode 值本身(
map[string]int可,*map[string]int易出错) - 并发使用同一 encoder/decoder 不安全;每个 goroutine 应独占实例










