Go embedding 怎么处理提升方法

写 Go 结构体时，把 Base 直接写进 Order，常常就会遇到一个问题：为什么可以直接调用 o.Save()，换成指针接收者后却又像“方法不存在”？关键不在继承，而在 embedding 对 selector 和方法集的组合规则。嵌入字段的方法可以被提升到外层，但值类型、指针类型和同名成员仍然各自有边界。

先记住一句话：嵌入 T 时，值和指针外层都能获得接收者为 T 的提升方法；只有指针外层才能稳定获得接收者为 *T 的方法。嵌入 *T 时，两类方法都可以被外层提升，但要先保证嵌入指针不是 nil。

先把 embedding 看成字段路径，而不是继承

下面的结构体中，Base 是匿名嵌入字段，字段名就是类型名。o.Save() 等价于沿着 o.Base.Save() 找方法，但 Base 仍然是一个真实字段，外层也可以声明自己的同名方法。

type Base struct{}

// Save 使用值接收者，Base 和 *Base 都能使用它。
func (Base) Save() {}

type Order struct {
    Base // 匿名嵌入字段，字段名为 Base
}

func example(o Order) {
    o.Save()      // 提升调用，等价于 o.Base.Save()
    o.Base.Save() // 显式调用，排查时更清楚
}

规范把成员到外层的层数称为 depth。外层声明的成员深度为 0，嵌入字段里的成员深度至少为 1；selector 会先选最浅层的唯一成员。因此，排查“调用到了谁”时，先改成显式字段路径，通常比继续猜方法集更快。

值方法和指针方法要分开判断

真正容易出错的是接收者类型。假设 Base 还有一个指针方法：

// Reset 修改接收者状态，因此使用指针接收者。
func (b *Base) Reset() {}

type Order struct {
    Base // 嵌入值 Base
}

func check(o Order) {
    o.Save() // 可以调用值方法
    o.Reset() // 这里依赖可取地址的调用场景
    (&o).Reset() // 显式取地址，意图最明确
}

可以把常见情况压缩成这张表。它说的是方法集和 selector 规则，不是“所有场景都自动复制方法”。

写接口转换时，不要用“看起来能调用”代替方法集判断。值接收者通常更宽，指针接收者则要求外层值可取地址，或直接使用外层指针。

同名方法出现时，显式路径就是答案

如果 Order 自己声明了 Save，它的深度为 0，会覆盖嵌入的 Base.Save：

func (Order) Save() {}

func call(o Order) {
    o.Save()      // 调用 Order.Save
    o.Base.Save() // 明确调用 Base.Save
}

如果两个不同嵌入字段在同一层都提供 Save，o.Save() 就没有唯一目标，编译器会报 selector 歧义。这里不要通过改变量类型碰运气，直接写 o.Left.Save() 或 o.Right.Save()，并检查是否真的需要两个匿名字段。

接口转换前做一次最小检查

接口只关心目标方法集是否完整。可以用编译期赋值把判断固定下来：

type Saver interface {
    Save()
    Reset()
}

// 指针外层通常能拿到嵌入值的两类提升方法。
var _ Saver = (*Order)(nil)

// 如果这里报错，优先检查 Reset 的接收者和 Order 的嵌入形式。
func use(s Saver) { s.Save(); s.Reset() }

另一个边界是嵌入 *Base 后的 nil。方法集上可能满足接口，不代表运行时一定安全；调用提升方法前要保证内部指针已经初始化，或者改成显式判断再调用。这个区别能解释很多“编译通过、请求一进来就 panic”的问题。

常见问题

提升方法会把方法复制到外层结构体吗？

不会。它是 selector 和方法集规则提供的便捷访问路径，方法的接收者仍然是嵌入字段。

为什么 T 能调用值方法，接口却不满足？

接口检查的是完整方法集。如果接口还要求指针接收者方法，值外层可能没有对应方法；改用外层指针或调整接口边界。

同名方法应该改名吗？

不一定。先用显式字段路径确认意图；只有当两个嵌入字段长期表达同一职责、导致调用者频繁消歧时，才考虑改成具名字段或重新划分接口。