Go中JSON/XML/gob序列化要求所有字段（含嵌套结构体内字段）必须首字母大写导出，否则静默忽略；需显式添加json/xml标签精确映射，嵌套层级须用结构体建模而非点号路径。
导出嵌套结构前，必须确认字段是否全部导出
Go 的 encoding/json、encoding/xml 和 gob 都只处理首字母大写的导出字段。小写字段（如 host string）在序列化时会被静默忽略，不报错也不警告，最终输出里就没了。
常见错误现象：结构体定义看着没问题，但生成的 JSON/XML 文件里关键字段为空或直接消失；用 gob 存完再读，字段值全为零值。
- 所有要导出的字段名必须以大写字母开头（
Host，不是host） - 嵌套结构体里的字段同样要导出——哪怕外层结构体已导出，内层小写字段仍无效
- 匿名字段若为结构体，其类型也必须是导出类型（
type HostConfig struct {...}，不能是struct{...}） - 别依赖字段名和 JSON key 碰巧一致（比如 Go 字段叫
Name，JSON 里也叫"name"），必须显式加json:"name"标签，否则重命名后就断了
JSON 导出时，嵌套层级不能靠点号标签“跳级”
json:"user.name" 这种写法在 Go 的 encoding/json 中完全无效。它不会把字段塞进 user 对象下的 name，而是当成一个字面键名，导致解析失败或字段丢失。
正确做法是用嵌套结构体建模，每一层都对应真实 JSON 层级：
立即学习“go语言免费学习笔记（深入）”；
type Response struct {
Data DataItem `json:"data"`
}
type DataItem struct {
Name string `json:"name"`
Items []Item `json:"items"`
}
type Item struct {
ID int `json:"id"`
Type string `json:"type"`
}
- 切片字段（如
[]Item）必须配对json:"items"，不能写成json:"data>items"——json包不支持路径式标签 - 空对象
{}解到结构体会成功，但所有字段保持零值；解到map[string]interface{}得到空 map，行为不同，别混用 - 如果某层可能缺失（比如
"data"有时是null），别硬绑结构体，改用json.RawMessage缓存原始字节，后续按需解析
XML 导出时，标签语法错一个字符就静默归零
xml:"id,attr" 写成 xml:"id attr" 或 xml:"id,attribute"，字段就永远为空，且不 panic、不报错。这是 encoding/xml 最隐蔽的坑。
属性、子元素、CDATA、嵌套路径，每种角色都要用精确语法：
- 属性必须用
,attr（逗号 + attr），不能少逗号，也不能拼错 - CData 内容用
,cdata（注意是小写 cdata，不是cdata或CDATA） - 跳过中间容器节点用
xml:"a>b>c"，Go 1.19+ 稳定支持；旧版本对 >2 层嵌套（如a>b>c>d）可能失效 - 命名空间必须显式声明，如
xml:"dc:title"，且结构体需提前注册 namespace，否则字段丢值 - 切片字段（如
[]Book）标签必须与 XML 实际标签名一致：xml:"book"，不是xml:"books>book"
选 gob 还是 JSON？取决于你是否需要跨语言或保真运行时结构
如果导出目标只是 Go 进程自己读，比如缓存中间状态、保存 session、序列化带私有字段的配置快照，gob 是唯一能保真的选择；它能完整保留未导出字段、指针关系、channel、甚至方法绑定。
但如果要给人看、给前端用、或被其他语言消费，只能选 JSON（或 YAML/TOML）。
- 用
gob前，确保读写两端 struct 定义完全一致——字段增删、类型变更、包路径变动都会导致解码 panic - 用
json.MarshalIndent而非json.Marshal，方便调试和人工核对 - 别混用格式：用
gob写的文件，不能用json.Unmarshal读；反过来也一样，会直接 panic - 上传/下载场景下，别先
json.Unmarshal再json.Marshal——这纯属浪费 CPU 和内存，直接io.Copy流式转发更稳
xml: 标签少了个逗号、或者 gob 两端 struct 定义差了一个字段。这些错误都不报 panic，只默默丢数据。 
