gob仅适用于同一版本Go程序间可信的短期数据传输;它不跨语言、无版本兼容性、要求字段导出且类型提前注册,结构变更易导致panic。
Go 的 encoding/gob 不适合跨语言或长期存储,只应在可信的 Go 进程间传递结构化数据。
gob 而不是 json 或 protobuf
gob 是 Go 原生二进制序列化机制,特点是:类型信息随数据一起编码、不依赖 schema 定义、支持私有字段(只要可导出)、能直接序列化 channel/function/map 等复杂类型(但反序列化时有约束)。它唯一合理场景是:同一版本 Go 程序内部或相互信任的 Go 服务之间做短期内存/网络传输

gob: type not found 或 field mismatch)json 更通用,protobuf 更紧凑且跨语言gob 序列化必须满足的三个条件否则运行时会 panic 或静默失败:
gob 不会报错,但字段值不会写入reflect.New 创建零值实例),不能依赖自定义构造函数gob 支持的类型,例如:time.Time 可以,sql.NullString 默认不行(需注册 gob.Register)gob 处理 interface{} 和自定义类型gob 对 interface{} 的处理很特殊:它只保存运行时具体类型的值,反序列化时也必须提前注册该类型,否则报 gob: unknown type id or name。常见做法:
gob.Register(&MyStruct{}) 或 gob.Register(MyStruct{})(推荐传指针,避免值拷贝)interface{} 存多种类型,建议封装一层带 type tag 的 struct,而不是裸用 interface{}
type UserID int64)默认可序列化;但带方法或非标准底层类型的别名(如 type Status uint8 加了 String() 方法)最好显式 Register
示例:
var buf bytes.Buffer
enc := gob.NewEncoder(&buf)
gob.Register(&User{})
enc.Encode(&User{Name: "Alice"}) // 必须先 Register 才能 Encode interface{} 值
gob 反序列化后切片长度为 0 或字段为空最常见原因是:目标变量未初始化为指针,或接收变量类型与编码时不一致。例如:
var u User; dec.Decode(&u) → 正确,但若写成 dec.Decode(u)(传值)则解码失败且无提示Age int → Age *int),旧数据无法自动转为指针,解码后为 nilmap[string]interface{} 接收时,gob 会按 runtime 类型还原,但若原始是 map[string]string,反序列化后仍是 map[string]string,不会变成 interface{}
调试建议:用 gob.NewDecoder(bytes.NewReader(buf.Bytes())).Decode(&v) 后立刻检查 err,不要忽略返回值。
真正麻烦的是类型演化——gob 没有版本迁移机制,加字段容易,删字段或改类型基本只能停服升级。如果业务需要向前兼容,别碰 gob。