当嵌入的结构体实现了 MarshalJSON() 方法时，Go 会自动将其方法提升到外层结构体，导致字段丢失；本文介绍两种主流解决方案：一是将定制逻辑下移到字段级类型（推荐），二是在外层手动组合 JSON 序列化结果。
当嵌入的结构体实现了 `marshaljson()` 方法时，go 会自动将其方法提升到外层结构体，导致字段丢失；本文介绍两种主流解决方案：一是将定制逻辑下移到字段级类型（推荐），二是在外层手动组合 json 序列化结果。
在 Go 的 JSON 序列化机制中，若一个结构体嵌入了另一个实现了 json.Marshaler 接口（如 MarshalJSON()）的类型，该方法会被自动提升（promoted） 到外层结构体上——这意味着调用 json.Marshal() 时，整个外层结构体都会交由内嵌类型的 MarshalJSON() 处理，而外层自身字段（如 JobRole）将被完全忽略。这正是问题中 Employee 序列化后丢失 "jobRole" 字段的根本原因。
✅ 推荐方案：将序列化逻辑下沉至字段类型（Idiomatic）
最符合 Go 习惯、可复用且无副作用的做法是：避免在嵌入结构体上实现 MarshalJSON()，而是为需要定制的字段定义独立类型，并让该类型实现 MarshalJSON()。
type Name string
func (n Name) MarshalJSON() ([]byte, error) {
return json.Marshal(strings.ToUpper(string(n)))
}
type Person struct {
Name Name `json:"name"`
}
type Employee struct {
*Person
JobRole string `json:"jobRole"`
}此时 Person 不再实现 json.Marshaler，因此 Employee 的嵌入不会触发方法提升；json.Marshal(e) 将正常遍历所有导出字段：先调用 Name.MarshalJSON() 得到 "BOB"，再序列化 JobRole 字段，最终输出：
{"name":"BOB","jobRole":"Sales"}✅ 优势显著：
- 无需修改外层结构体逻辑，天然支持任意嵌套层级；
- 字段行为正交：Name 的大小写转换逻辑与其所在结构体解耦；
- 完全兼容标准库，无反射、无 map[string]interface{} 解析开销；
- 可轻松复用于 Customer、Student 等其他含 Name 字段的结构体。
⚠️ 替代方案：外层显式组合（适用于无法修改内嵌类型时）
若 Person 来自第三方包且已固定实现 MarshalJSON()，你无法修改其定义，则必须在外层 Employee 中显式实现 MarshalJSON()，并手动组合结果：
func (e *Employee) MarshalJSON() ([]byte, error) {
// 步骤1：获取 Person 的定制 JSON
personJSON, err := e.Person.MarshalJSON()
if err != nil {
return nil, err
}
// 步骤2：反序列化为 map（注意：字段顺序不保证）
var personMap map[string]interface{}
if err := json.Unmarshal(personJSON, &personMap); err != nil {
return nil, err
}
// 步骤3：注入 Employee 自身字段
personMap["jobRole"] = e.JobRole
// 步骤4：重新序列化
return json.Marshal(personMap)
}⚠️ 注意事项：
- 字段顺序不可控：map[string]interface{} 无序，jobRole 可能出现在 name 前；
- 性能开销：涉及两次序列化/反序列化，对高频场景不友好；
- 脆弱性：依赖内嵌类型 MarshalJSON() 输出为合法对象 JSON（不能是字符串或数组）；
- 维护成本高：每新增一个外层字段，都需在此方法中显式添加。
总结
| 方案 | 适用场景 | 可维护性 | 性能 | 推荐度 |
|---|---|---|---|---|
| 字段级类型 + MarshalJSON() | 可控制字段定义（首选） | ★★★★★ | ★★★★★ | ⭐⭐⭐⭐⭐ |
| 外层 MarshalJSON() 组合 | 必须兼容不可改的第三方嵌入类型 | ★★☆☆☆ | ★★☆☆☆ | ⭐⭐☆☆☆ |
核心原则：Go 的嵌入是“字段共享 + 方法提升”，而非“组合委托”。要实现精细控制，应优先通过类型建模（type-based customization） 而非结构体层级干预。将语义与行为绑定到最小粒度（字段类型），才是真正符合 Go idioms 的做法。
