必须用指针接收者实现接口的两种情况：一是方法需修改接收者状态（如io.Writer.Write），二是结构体较大（>16字节）避免拷贝开销；因T与*T方法集不同，值类型不包含指针接收者方法。
为什么用指针接收者才能实现接口？
因为 Go 的接口实现判定基于「方法集」，而类型 T 的方法集只包含值接收者方法；*T 的方法集才同时包含值接收者和指针接收者方法。如果你定义了一个带指针接收者的方法，却用值类型变量去赋值接口变量，编译器会报错：cannot use t (type T) as type InterfaceName in assignment: T does not implement InterfaceName (MethodX method has pointer receiver)。
常见错误现象：结构体实现了接口方法，但传入函数时提示“does not implement”，尤其是用 fmt.Println 或 json.Marshal 这类接受 interface{} 的函数时突然炸了。
- 值类型变量（如
t T）只能调用值接收者方法，且只能满足「只含值接收者方法」的接口 - 指针类型变量（如
t *T）既能调用值接收者方法，也能调用指针接收者方法，能实现更广的接口 - 如果方法内要修改接收者字段，必须用指针接收者——这不是接口问题，是语义需求
什么时候必须用指针接收者实现接口？
不是“想用就用”，而是两类场景下别无选择：
- 接口方法签名本身要求修改状态，比如
Write(p []byte) (n int, err error)（io.Writer），内部要更新缓冲区或偏移量 - 结构体较大（比如含 slice、map、大数组或嵌套结构），值拷贝开销明显，Go 团队在标准库中普遍对 >16 字节的 struct 使用指针接收者
典型例子：bytes.Buffer 所有方法都是指针接收者，因为它的 buf []byte 字段可能很大；而 time.Time 是值接收者——它只是 24 字节的封装，拷贝便宜，且不可变。
立即学习“go语言免费学习笔记（深入）”；
值接收者 vs 指针接收者：方法集差异一目了然
假设你定义了：
type Speaker struct{ Name string }
func (s Speaker) Say() string { return s.Name }
func (s *Speaker) SetName(n string) { s.Name = n }
那么：
-
Speaker类型的方法集 = {Say} -
*Speaker类型的方法集 = {Say,SetName}
所以：var s Speaker; var _ io.Stringer = s 成立（只要 Say 满足 String()）；但若接口需要 SetName，就必须写 var sp *Speaker; var _ InterfaceWithSet = sp。别指望编译器自动取地址——它只看变量声明类型，不推导上下文。
嵌入结构体时指针接收者的陷阱
嵌入（embedding）不会自动提升方法集的接收者类型。比如：
type Logger struct{}
func (l *Logger) Log(s string) {}
type App struct {
Logger
}
这时 App 类型本身没有 Log 方法——因为嵌入的是 Logger（值类型），而 Log 是指针接收者。解决办法只有两个：
- 嵌入指针：
Logger *Logger（推荐，显式且安全） - 把
Log改成值接收者（仅当方法不修改Logger内部状态时可行）
这个坑在写中间件、配置包装器时特别容易踩：你以为嵌入就“继承”了所有行为，结果调用时 panic 或静默失败。
接口实现不是靠“看起来像”，而是编译期严格检查方法集。哪怕只差一个 *，就是两个完全不同的类型。
