go 的 encoding/json 包仅序列化导出（首字母大写）字段；嵌入结构体若无导出字段，将生成空 json 对象 {}。
go 的 encoding/json 包仅序列化导出（首字母大写）字段；嵌入结构体若无导出字段，将生成空 json 对象 {}。
在 Go 语言中，结构体嵌入（embedding）是一种实现组合与代码复用的重要机制。但当配合 json.Marshal 使用时，开发者常遇到一个典型问题：嵌入了其他结构体的类型，序列化后却得到空对象 {}——看似“丢失”了所有字段。根本原因并非嵌入机制失效，而是 Go 的导出规则（Export Rule） 与 encoding/json 包的设计严格绑定。
? 核心原则：只有导出字段才可被 JSON 编码
Go 规定：只有首字母大写的标识符（即导出字段）才能被外部包访问。而 encoding/json 是一个独立包，它无法读取未导出（小写首字母）字段的值，因此会直接忽略它们，最终生成空 JSON 对象。
例如，以下代码会导致空输出：
type Parent struct {
name string // 小写 → 未导出 → JSON 忽略
value int // 小写 → 未导出 → JSON 忽略
}
type Child struct {
Parent // 嵌入
}c := Child{Parent: Parent{"Alice", 42}}
data, _ := json.Marshal(c)
fmt.Println(string(data)) // 输出：{}✅ 正确做法：确保嵌入结构体的字段全部导出
只需将字段名首字母大写，并按需调整 JSON 字段名（通过 struct tag）：
type Parent struct {
Name string `json:"name"`
Value int `json:"value"`
}
type Child struct {
Parent // 嵌入（自动获得 Name、Value 字段）
}c := Child{Parent: Parent{"Alice", 42}}
data, _ := json.Marshal(c)
fmt.Println(string(data)) // 输出：{"name":"Alice","value":42}⚠️ 注意事项：
- 若嵌入结构体中定义了同名方法（如 Name()），而字段也命名为 Name，则会引发编译错误（字段与方法重名）。此时应重命名字段（如 NameVal）或方法（如 GetName()），避免冲突；
- 嵌入结构体本身无需额外 tag，其导出字段会自然“提升”到外层结构体中参与序列化；
- 可使用 - tag 显式排除某个导出字段：Age intjson:"-"`。
? 总结
JSON 序列化行为完全由字段可见性驱动，而非嵌入语法本身。解决 {} 问题的关键在于：检查所有层级的字段是否均以大写字母开头。嵌入结构体不是“黑盒”，它的导出字段会成为外层结构体的逻辑组成部分——只要它们可见，就能被正确编码。养成定义结构体时默认使用导出字段的习惯，并善用 json tag 控制序列化格式，即可避免此类静默失败。
