gob.Encode 不能直接序列化私有字段，仅导出字段（首字母大写）被编码；私有字段被静默忽略，导致 Decode 后值为空或零值；需改用导出字段或实现 GobEncode/GobDecode，并提前注册类型，且注意跨版本兼容性差、tag 无效、字段变更不校验。
gob.Encode 不能直接序列化私有字段
Go 的 gob 协议只编码导出（首字母大写）的结构体字段，私有字段（小写字母开头）默认被跳过，哪怕你手动调用 gob.NewEncoder().Encode() 也一样——它不报错，但字段值就是丢了。
常见错误现象：Decode 后结构体字段为空或零值，而你确认赋了值；调试时发现 gob.Encoder 输出的字节流明显偏短。
- 必须把要传输的字段改为导出字段（如
Name而非name） - 如果不能改结构体定义（比如封装在第三方包里），得用自定义的
GobEncode/GobDecode方法手动控制序列化逻辑 - 注意：
GobEncode返回的[]byte会被原样传给对端GobDecode，中间不校验结构，错配就 panic
自定义 GobEncode/GobDecode 时容易漏掉类型注册
gob 在 encode/decode 自定义方法时，如果返回或接收的类型不是基础类型（比如返回 []interface{} 或嵌套自定义 struct），必须提前用 gob.Register() 注册，否则运行时报 gob: unknown type id or corrupted data。
使用场景：你想隐藏内部字段，只暴露加密后的字节流，于是让 GobEncode 返回 []byte，再由 GobDecode 解密还原。
立即学习“go语言免费学习笔记（深入）”；
- 注册要在任何 encode/decode 操作前完成，通常放在
init()函数里 - 注册对象是具体类型，不是接口；例如注册了
*MyStruct，就不能用MyStruct去 decode - 如果跨进程通信（比如 client/server），两端代码必须注册完全相同的类型，顺序无关，但类型定义必须一致
gob 在不同 Go 版本间兼容性差
gob 不是稳定格式协议，Go 主版本升级（如 1.19 → 1.22）可能改变内部编码细节。生产环境里，用 gob 做长期存储或跨服务持久化，基本等于埋雷。
性能影响不大，但兼容性风险极高：旧版 encode 的数据，新版 gob.Decode 可能 panic，错误信息通常是 gob: type not found 或 invalid interface type。
- 仅限可信、同版本、短期内存/网络传输（如 RPC 内部通信）
- 避免写入磁盘文件，除非你明确控制所有读写方的 Go 版本和 struct 定义
- 替代方案更推荐
encoding/json（可读、稳定）或protobuf（高效、跨语言），哪怕多几行代码
struct 字段 tag 对 gob 完全无效
别在 struct 字段上加 gob:"-" 或 gob:"name" 这类 tag——gob 解析器压根不看它们。这和 json 或 xml 包完全不同。
常见错误：照着 JSON 的习惯写 type User struct { Name string `gob:"username"` }，结果还是 encode 出 Name 字段，tag 被忽略。
- 控制字段是否参与 gob 编码，只有两个办法：改字段名大小写，或实现
GobEncode/GobDecode - 想临时跳过某个导出字段？只能在
GobEncode里手动过滤，没有“开关”式配置 - 字段重命名需求（比如把
IDencode 成id）必须靠自定义方法 + 显式字段赋值
