如何使用Golang encoding/gob进行对象序列化_Golang gob序列化方法 返回列表

gob序列化要求结构体字段必须导出（首字母大写），匿名嵌入类型也需导出，map/slice等复合类型需满足导出要求；必须用gob.Encoder/gob.Decoder流式编解码，多次Encode需按序Decode；含接口或未导出类型须提前注册；不兼容跨语言及长期持久化。

gob 序列化必须要求结构体字段可导出

Go 的 encoding/gob 只能序列化**导出字段**（即首字母大写的字段），私有字段（小写开头）会被静默忽略，且不报错。这是最常见的“序列化后数据为空”或“反序列化字段为零值”的根源。

• 结构体字段名必须以大写字母开头，例如 UserName、Age，不能是 userName 或 age
• 如果字段是匿名嵌入的结构体，该结构体本身也必须是导出类型（如 UserDetail 而非 userDetail）
• map、slice、channel 等复合类型字段只要可导出，就能正常序列化；但 map 的 key 和 value 类型也需满足导出要求

用 gob.Encoder 和 gob.Decoder 处理 io.Writer/io.Reader

gob 不提供类似 json.Marshal 那样的单次内存转换函数，它基于流式编解码器设计，必须通过 gob.Encoder 写入 io.Writer，用 gob.Decoder 从 io.Reader 读取。直接传入字节切片需包装成 bytes.Buffer 或 bytes.Reader。

var buf bytes.Buffer
enc := gob.NewEncoder(&buf)
err := enc.Encode(User{UserName: "alice", Age: 30})
if err != nil {
    log.Fatal(err)
}

var u User
dec := gob.NewDecoder(&buf)
err = dec.Decode(&u)
if err != nil {
    log.Fatal(err)
}

• 每次 Encode 写入一个完整值；多次 Encode 会连续写入，Decode 必须按相同顺序、相同类型依次读取
• 不能跳过某个值去读后面的——gob 没有随机访问能力
• 务必检查 err：比如类型不匹配、字段缺失、io.EOF 等都会在这里暴露

跨进程/网络传输前必须注册自定义类型（尤其含接口或未导出字段时）

如果结构体中包含接口字段（如 io.Reader）、或使用了未导出类型（如内部定义的 type ID int），gob 默认无法识别其具体实现，反序列化会失败并报 gob: type not registered for interface 或类似错误。

• 在编码和解码两端都调用 gob.Register() 注册具体类型，例如：gob.Register((*bytes.Buffer)(nil))
• 若结构体含接口字段，且运行时可能赋值多种具体类型（如 io.Reader 可能是 *bytes.Buffer 或 *strings.Reader），则这些具体类型都需注册
• 注册必须在首次 Encode 或 Decode 之前完成，且两端注册顺序和内容需一致

gob 不兼容 JSON/YAML，也不保证跨 Go 版本长期稳定

gob 是 Go 专用二进制格式，设计目标是 Go 进程间高效通信，不是通用数据交换格式。它不承诺向后或向前兼容——同一结构体在 Go 1.18 编码的数据，Go 1.22 可能无法正确解码，尤其是涉及泛型、内嵌字段变更或反射行为调整时。

• 不要将 gob 数据持久化到磁盘长期保存，除非你严格控制 Go 版本并自行维护迁移逻辑
• 不要用 gob 与非 Go 系统交互；需要跨语言请选 Protocol Buffers、JSON 或 MessagePack
• 调试时可用 gob.DebugWriter 输出编码过程的调试信息，但仅限开发阶段

真正要用好 gob，关键是守住它的边界：同版本 Go、同结构体定义、同注册状态、流式顺序读写——漏掉任一环，问题往往藏得深、报错不直观。