Go语言方法集与接口实现_Golang值接收者与指针接收者区别-Golang-PHP中文网

Go接口实现失败时，需检查接收者类型是否匹配：值类型T只能实现接收者为T的方法，而指针类型T可实现接收者为T或T的方法；修改字段、大型结构体及统一风格均应优先使用*T接收者。

go语言方法集与接口实现_golang值接收者与指针接收者区别

接口实现失败时，先查接收者类型是否匹配

Go 编译器判断一个类型是否实现某接口，严格依据「方法集」规则：类型 T 的方法集只包含接收者为 T 的方法；而指针类型 *T 的方法集包含接收者为 T 和 *T 的所有方法。这意味着——如果接口中某个方法声明的是 *T 接收者，那么只有 *T 能满足该接口，T 值类型直接被排除。

常见错误现象：cannot use t (type T) as type MyInterface in argument to foo: T does not implement MyInterface (Method needs pointer receiver)

不是代码写错了，而是你把一个值类型的变量（如 var x MyStruct）直接传给了期望 MyInterface 的函数，而该接口的方法全用 *MyStruct 定义
修复方式很简单：传 &x，或声明变量时就用指针 x := &MyStruct{}
若你控制接口定义，且确定所有实现都应支持值/指针调用，就统一用 *T 声明方法——这是更稳妥的默认选择

修改结构体字段必须用指针接收者

值接收者方法内部操作的是结构体副本，任何字段赋值都不会反映到原始实例上。这和 C 的传值语义一致，不是 bug，是设计使然。

例如：

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

type Counter struct{ n int }
func (c Counter) Inc() { c.n++ }     // 无效：改的是副本
func (c *Counter) Inc() { c.n++ }   // 有效：改的是原地址

调用 c.Inc() 时，Go 会自动在值上调用指针方法（即等价于 (&c).Inc()），但前提是方法本身是 *T 接收者
不要指望「编译器帮我转」就能让值接收者修改原值——它不转，也不该转
哪怕结构体只有 1 个 int 字段，只要方法要改它，就必须用 *T

大型结构体建议统一用指针接收者

值接收者会触发完整结构体拷贝。当结构体含切片、map、channel 或超过 3–4 个字段时，一次方法调用可能带来几十甚至上百字节的栈拷贝开销，且随调用频次线性放大。

典型高开销结构体：type Request struct { URL string; Headers map[string]string; Body []byte; Timeout time.Duration }
即使方法只读（如 func (r Request) Host() string），也推荐写成 func (r *Request) Host() string
小结构体（如 type Point struct{ x, y int }）用值接收者反而更轻量，无额外解引用成本