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 可能无法正确解码，尤其是涉及泛型、内嵌字段变更或反射行为调整时。
立即学习“go语言免费学习笔记（深入）”；
- 不要将 gob 数据持久化到磁盘长期保存，除非你严格控制 Go 版本并自行维护迁移逻辑
- 不要用 gob 与非 Go 系统交互；需要跨语言请选 Protocol Buffers、JSON 或 MessagePack
- 调试时可用
gob.DebugWriter输出编码过程的调试信息，但仅限开发阶段
真正要用好 gob，关键是守住它的边界：同版本 Go、同结构体定义、同注册状态、流式顺序读写——漏掉任一环，问题往往藏得深、报错不直观。
