当 go 结构体嵌入了带有自定义 `unmarshal
js
on` 方法的类型时，外层结构体若也实现该方法，需谨慎处理别名类型（alias type）以避免嵌入类型的 `unmarshal
json
` 被意外继承，否则会导致字段丢失。
在 Go 的 JSON 反序列化机制中，json.Unmarshal 对实现了 UnmarshalJSON 接口的类型会
优先调用其自定义方法
；而当该方法内部使用别名类型（如 type Alias Foo）进行递归反序列化时，必须确保该别名
完全剥离所有方法
——包括嵌入字段所“提升”（promoted）的方法。
问题核心在于：type Alias Foo 确实不继承 Foo 自身的方法（防止无限递归），但它
仍会继承嵌入字段 EmbeddedStruct 所提供的 UnmarshalJSON 方法
（因为 Go 的字段提升规则对别名类型同样生效）。因此，json.Unmarshal(from, alias) 实际调用的是 EmbeddedStruct.UnmarshalJSON，而非默认的结构体字段映射逻辑，导致外层字段（如 Field）被忽略。
✅ 正确做法是：在 Foo.UnmarshalJSON 中，
为别名显式声明一个空结构体
，彻底隔离嵌入类型的自定义反序列化行为：
go语言参考手册 中文CHM版
Go 是一个开源的编程语言，它能让构造简单、可靠且高效的软件变得容易。本文给大家带来Go参考手册，需要的可以来下载！ Go是从2007年末由Robert Griesemer, Rob Pike, Ken Thompson主持开发，后来还加入了Ian Lance Taylor, Russ Cox等人，并最终于2009年11月开源，在2012年早些时候发布了Go 1稳定版本。现在Go的开发已经是完全开放的，并且拥有一个活跃的社区。 Go 语言特色 简洁、快速、安全 并行、有趣、开源 内存管理、v数组安全、编译
下载
⚠️ 注意事项：
不要依赖 type Alias Foo —— 它会隐式携带嵌入类型的 UnmarshalJSON，破坏预期行为；
若嵌入结构体字段较多或需复用逻辑，可将 EmbeddedStruct 的反序列化提取为独立函数（不依赖方法），并在 Foo.UnmarshalJSON 中显式调用；
始终使用 &alias 传参给 json.Unmarshal，避免值拷贝导致解包失败；
测试时建议覆盖边界场景：缺失字段、空 JSON 对象、嵌套结构等。
? 总结：Go 的嵌入与方法提升机制在自定义反序列化中是一把双刃剑。安全实践是——
在别名中放弃结构体继承，改用显式字段定义
，从而获得完全可控的 JSON 映射行为。这不仅规避了方法冲突，也提升了
代码可读性
与可维护性。
func (d *Foo) UnmarshalJSON(from []byte) error {
fmt.Printf("Foo.UnmarshalJSON\n")
// 关键：定义无嵌入、无方法的纯数据别名
type Alias struct {
EmbeddedField string `json:"EmbeddedField"`
Field string `json:"Field"`
}
var alias Alias
if err := json.Unmarshal(from, &alias); err != nil {
return fmt.Errorf("failed to unmarshal Foo: %w", err)
}
// 手动赋值（或通过组合还原）
d.EmbeddedField = alias.EmbeddedField
d.Field = alias.Field
return nil
}