gob.Encode需先创建可写文件句柄，仅接受io.Writer；字段必须导出才能编码；不跨Go版本或结构体变更复用；含interface{}需提前gob.Register；适合可控环境短生命周期数据交换。
gob.Encode 写文件前必须先创建可写文件句柄
直接用 gob.Encode 无法写入磁盘，它只接受 io.Writer 接口。常见错误是传入一个只读文件或未打开的路径字符串，导致 panic 或静默失败。
正确做法是先用 os.Create 或 os.OpenFile 获取 *os.File，再传给 gob.NewEncoder：
file, err := os.Create("data.gob")
if err != nil {
log.Fatal(err)
}
defer file.Close()
enc := gob.NewEncoder(file)
err = enc.Encode(myStruct)
if err != nil {
log.Fatal(err)
}
- 务必检查
enc.Encode的返回值 —— 它可能因底层 write 失败（如磁盘满）而报错，但不会自动 flush - 不用手动调用
file.Sync()，gob.Encoder在Encode结束时已写入缓冲区；但若需强持久化（如断电不丢），才加file.Sync() - 文件后缀名无强制要求，但用
.gob便于识别和避免被其他工具误读
结构体字段必须导出才能被 gob 编码
gob 只序列化首字母大写的导出字段。小写开头的字段（如 id int、name string）会被完全忽略，且不报错 —— 这是最容易踩的坑。
示例中若定义：
立即学习“go语言免费学习笔记（深入）”；
type User struct {
ID int // ✅ 导出，会被编码
name string // ❌ 未导出，静默跳过
}
编码后解码得到的 User 实例中 name 永远是零值（""），且无任何提示。
- 嵌套结构体同理：所有层级的字段都必须导出
- 支持内建类型、导出结构体、切片、map、指针，但不支持 channel、function、unsafe.Pointer
- 如果需要编码私有字段，得自己实现
GobEncode/GobDecode方法
gob 文件不能跨 Go 版本或结构体变更后直接复用
gob 不是稳定格式协议，它依赖 Go 运行时对类型的内部表示。以下情况会导致 gob.Decode panic 报 "cannot decode type xxx" 或字段错位：
- Go 小版本升级后（如 1.21.x → 1.22.x），部分类型编码方式可能微调
- 结构体增删字段、改字段顺序、改字段名（即使只是大小写）、改嵌套深度
- 同一结构体在不同包里定义（哪怕字段完全一样），
gob视为不同类型
生产环境若需长期存档，别依赖 gob 做持久化存储。临时进程间通信或单机缓存可以，但要确保编码/解码两端的 Go 版本一致、结构体定义完全相同。
写入前建议显式注册自定义类型（尤其含接口或非导出字段）
当结构体含 interface{} 字段，或你实现了 GobEncode 方法，必须提前调用 gob.Register，否则运行时报 "type not registered for interface"。
例如：
type Payload struct {
Data interface{} // 存放 *User 或 []int
}
gob.Register(&User{}) // ✅ 必须注册具体类型
gob.Register([]int{}) // ✅ 若可能存 slice
file, _ := os.Create("p.gob")
enc := gob.NewEncoder(file)
enc.Encode(Payload{Data: &User{ID: 123}})
- 注册只需一次，通常放在
init()函数里 - 注册指针类型（
*User）比注册值类型（User）更稳妥，因为gob内部常以指针形式处理 - 如果类型来自第三方包，确保该包已导入，否则
gob.Register会静默失败
gob 就不认了 —— 它适合可控环境下的短生命周期数据交换，别把它当通用序列化格式使。 
