Go 接口的方法集为什么让指针实现而值类型不实现

Go 接口赋值报错时，先不要给类型强行加转换。最常见的原因是：值类型 T 的方法集只包含值接收者方法，而指针类型 *T 的方法集同时包含值接收者和指针接收者方法。因此，满足接口的可能是 *T，不是 T。

先用方法集规则判断 T 和 *T

设有一个 Document 类型。Summary 使用值接收者，Rename 使用指针接收者：

type Writer interface {
	Rename(string) error
}

type Document struct {
	Name string
}

// 值接收者方法进入 Document 和 *Document 的方法集。
func (d Document) Summary() string {
	return d.Name
}

// 指针接收者方法只进入 *Document 的方法集，并且可以修改原对象。
func (d *Document) Rename(name string) error {
	if d == nil || name == "" {
		return fmt.Errorf("文档名称不能为空")
	}
	d.Name = name
	return nil
}

此时可以把方法集写成一张速查表。接口 Writer 要求 Rename(string) error，只有拥有这个方法的类型才实现它。

用最小代码定位接口赋值失败

排查时可以用编译期断言把判断写在代码里。下面这一行故意不成立，删除它即可让示例继续编译；它的价值在于把“谁实现接口”变成明确的检查点。

var _ Writer = (*Document)(nil) // 编译期确认指针类型实现 Writer
// var _ Writer = Document{}    // 编译器会提示 Document 缺少 Rename 方法

这里的 nil 只是用于类型检查，不会调用方法，也不会创建运行时文档。若错误信息写着 Document does not implement Writer，应先检查接口要求的方法是否使用了指针接收者，再决定赋值处是否改成 &doc。

注意，接口变量保存的是动态类型和值。写成 var w Writer = &doc 时，动态类型是 *Document；写成 var w Writer = doc 时，编译器检查的是 Document 的方法集，不能因为它的地址在别处可取得就补上 Rename。

区分自动取址与接口赋值

很多误判来自下面这类代码：

doc := Document{Name: "旧名称"}

// 普通变量可寻址时，编译器允许把 doc.Rename 改写为 (&doc).Rename。
if err := doc.Rename("新名称"); err != nil {
	return err
}

// 接口赋值仍按 Document 的方法集检查，这一行不能替代上面的取址。
var w Writer = &doc
_ = w.Rename("发布名称")

doc.Rename 能调用，不代表 Document 已实现 Writer。前者是方法调用位置的语言便利，后者是接口赋值时的静态类型约束。值来自函数返回值、接口取值或不可寻址表达式时，自动取址本身也不能随意套用。

按数据语义选择值接收者或指针接收者

修复接口错误的最小改法通常是把值传给接口的地方改成指针：

func publish(w Writer) error {
	// 只依赖 Writer 的行为，不关心具体实现类型。
	return w.Rename("已发布")
}

doc := Document{Name: "草稿"}
// 指针类型的方法集包含 Rename，因此可以传入接口。
if err := publish(&doc); err != nil {
	return err
}

如果方法不修改状态、类型很小且复制语义清晰，可以全部使用值接收者，让 T 和 *T 都具备这组方法。若方法要修改字段、类型包含互斥锁等不应复制的状态，或需要保持同一对象身份，则应统一使用指针接收者，并在接口边界传递 *T。

常见问题

为什么把 doc 改成 &doc 就能实现接口？

因为接口检查的动态类型从 Document 变成了 *Document，而 *Document 的方法集包含指针接收者方法。

给方法加上值接收者是不是更省事？

不一定。值接收者可能复制结构体，且不能通过接收者修改原对象；先确认数据的复制和身份语义，再决定是否改签名。

接口里能不能同时接受 T 和 *T？

可以，但前提是 T 自身也拥有接口要求的全部方法，通常意味着相关方法都采用值接收者。

遇到“明明有这个方法却不实现接口”时，按“接口需要什么、接收者写成什么、当前表达式的静态类型是什么”三项逐一核对，通常比盲目转换更快定位问题。