Go 的 encoding/gob 是专为 Go 类型设计的高效二进制序列化方案，要求类型及字段均导出，支持指针、切片、map等，需注意类型注册、兼容性及并发安全。
Go 的 encoding/gob 是 Go 原生支持的二进制序列化方案，专为 Go 类型设计，性能高、开销小，适合进程内通信、RPC、缓存或持久化等场景。它不追求跨语言兼容性，但对 Go 类型（尤其是结构体）支持极好，且能自动处理指针、切片、map、嵌套结构等。
gob 编码前的关键准备
gob 要求被序列化的类型必须是可导出的（首字母大写），且字段也需导出才能参与编码/解码。未导出字段（小写开头）会被忽略，不会报错但也不会传输。
- 结构体必须是 public（如
type User struct，不能是type user struct） - 字段名必须大写（如
Name string，不是name string） - 支持基本类型、指针、切片、map、channel、interface{}（但 interface{} 中的实际值也需满足导出要求）
- 若含自定义类型（如枚举、别名类型），建议为其实现
GobEncode() / GobDecode()方法以控制行为
基础编码与解码操作
使用 gob.Encoder 和 gob.Decoder 配合任意 io.Writer 或 io.Reader（如 bytes.Buffer、文件、网络连接）即可完成编解码。
- 编码：创建
gob.NewEncoder(w io.Writer)，调用Encode(v interface{}) error - 解码：创建
gob.NewDecoder(r io.Reader)，调用Decode(v interface{}) error；注意目标变量需为指针（&u） - 同一 encoder/decoder 可连续 Encode 多个值，Decode 时顺序必须严格一致
- 示例中常使用
bytes.Buffer模拟内存流，实际中可换为os.File或net.Conn
处理类型注册与兼容性
gob 在编码时会记录类型信息，解码端需“知道”该类型——通常通过包级初始化或显式注册实现。当结构体字段增删、类型变更时，需注意向后兼容：
立即学习“go语言免费学习笔记（深入）”；
- 新增字段：解码旧数据时新字段取零值（安全）
- 删除字段：旧数据中该字段被跳过（只要不引起 panic，一般安全）
- 字段重命名或改类型：需手动注册别名或使用
GobEncoder接口做转换 - 跨包/动态类型：用
gob.Register()提前注册（如gob.Register(&User{})），避免运行时报 “type not registered”
实用技巧与避坑提醒
gob 看似简单，但几个细节容易引发隐性问题：
- 不要复用
gob.Encoder/Decoder实例跨 goroutine 使用——它们不是并发安全的 - 解码前确保目标变量已初始化（尤其 map/slice），否则可能 panic；推荐用指针 + 零值接收
- 时间（
time.Time）、错误（error）等标准类型默认支持，无需注册 - 若需加密或压缩，应在 gob 编码之后、写入底层 io 前处理（gob 本身不提供）
- 调试时可用
gob.DebugWriter查看编码内容（仅供开发，勿用于生产）
基本上就这些。gob 不复杂但容易忽略导出规则和类型注册，写一次跑通后稳定性很高，特别适合 Go 生态内部的高效数据交换。
