gob仅限同版本Go程序间使用，要求结构体定义完全一致；interface{}字段需显式注册具体类型；小写字段被静默忽略；Encoder/Decoder非线程安全，须每次新建实例。
gob 不是通用序列化协议，它只在 Go 程序之间、同版本、结构体定义完全一致的前提下才可靠工作；用错场景（比如存数据库、跨语言通信、长期持久化）会直接导致解码失败或静默丢字段。
gob.Encode 为什么 panic: "cannot encode unregistered interface"？
当你结构体里有 interface{} 字段，或者值本身就是 interface{} 类型（如 var msg interface{} = &User{}），gob.Encoder 在运行时无法知道该接口背后的具体类型，就会 panic。
- 必须在第一次
Encode或Decode前，用gob.Register()显式注册所有可能承载的**具体类型**，例如gob.Register(&User{})、gob.Register([]Post{})、gob.Register(map[string]*Config{}) - 注册的是类型本身，不是接口；注册
interface{}没用 - 如果用了嵌套接口（如
type Event struct{ Data interface{} }），要注册Data可能的所有实际值类型，一个都不能漏 - 别注册匿名 struct —— 每次编译生成的 type ID 不同，跨进程必失败
gob.Decode 报 EOF 或 “type mismatch” 怎么排查？
这不是流读完了，而是类型信息对不上。gob 在 encode 时把完整类型路径（包名 + 结构体名 + 字段顺序 + 是否导出）都写进二进制流了，decode 端只要有一点不匹配，就提前终止并报 EOF 或类型错误。
- 检查两端结构体定义是否**完全一致**：包路径（如
myapp.Uservsother.User）、字段名大小写（Name≠name）、字段顺序、是否导出（小写字段被跳过） - 确认没有删字段 —— 删字段会导致旧数据 decode 失败；加字段可以，但必须加在末尾，且新字段类型要兼容零值（如不能从
int改成*int） - 如果用
net.Conn传，发送方没调conn.CloseWrite()，接收方会一直等 EOF；建议改用消息边界（如先写长度）或每次 encode/decode 后 flush -
gob:"-"这类 tag 完全无效 —— gob 不解析任何 struct tag，字段跳过只能靠首字母小写
为什么结构体字段是小写却没报错，但 Decode 后是零值？
因为 gob 只编码**导出字段**（首字母大写的字段），小写字段被静默忽略，既不报错也不写入流。你看到的“成功 encode”，其实根本没传那个字段。
立即学习“go语言免费学习笔记（深入）”；
- 把字段名改成大写（如
name string→Name string）是最直接的修复方式 - 如果不能改结构体（比如封装在第三方库），必须实现
GobEncode() ([]byte, error)和GobDecode([]byte) error接口，自己控制字节流内容 - 自定义
GobEncode时，返回的[]byte仍需确保其中涉及的类型已注册（如含map[string]Custom，就得gob.Register(Custom{})） - 注意：
GobEncode和GobDecode是绕过 gob 默认反射逻辑的“逃生通道”，但也意味着你承担全部兼容性责任
gob 在并发场景下为什么会 panic 或数据错乱？
gob.Encoder 和 gob.Decoder 实例都不是线程安全的。复用同一个 encoder 实例在多个 goroutine 里调用 Encode，可能触发内部状态竞争，导致 panic 或输出损坏的字节流。
- 不要全局单例复用
gob.Encoder/gob.Decoder；每次序列化/反序列化都新建实例（开销极小） - 如果性能敏感、必须复用，得在外层加
sync.Mutex保护，但通常不值得 - 尤其注意 HTTP handler 或 RPC 方法里：常见错误是把 encoder 做成 struct 字段，在并发请求中被多 goroutine 共享
- bytes.Buffer 是线程安全的，但
gob.Encoder不是 —— 即使底层 writer 安全，encoder 自身状态也不安全
最常被忽略的一点：gob 的“类型一致性”不是指字段名和类型看起来一样，而是指 Go 编译器认定的**同一类型实体**。哪怕两个 struct 字段一模一样，只要定义在不同包、或名字不同、或哪怕只是字段顺序调换，gob 就认为是两种类型 —— 它不比较结构，只查类型 ID。
