必须用指针接收者:修改字段、大结构体、实现接口、统一风格——语义上表示“方法会改变接收者”,避免副本无效修改与接口实现失败。

需要修改字段?必须用指针接收者
如果方法内部要改结构体的任何字段,*T 是唯一选择。值接收者 T 操作的是副本,改了也白改。
-
func (u User) SetName(n string) { u.Name = n }→ 调用后u.Name不变 -
func (u *User) SetName(n string) { u.Name = n }→ 真正更新原对象 - 哪怕只改一个
int字段,只要语义上是“更新状态”,就该用指针
结构体大不大?影响性能和可读性
Go 会完整拷贝值接收者的整个结构体。字段多、含切片/映射/大数组时,复制开销明显。
- 小结构体(如
type Point { X, Y int })值接收者可接受 - 中等及以上(≥3 字段,或含
[]byte、map[string]int)建议统一用*T - 别为了“省几个字节”用值接收者——可维护性比微小性能更重要
实现了 interface?看方法集规则
接口实现与否,取决于类型的方法集是否包含所需方法。而方法集由接收者类型决定:
-
T的方法集只含值接收者方法 -
*T的方法集含值接收者 + 指针接收者方法 - 若某方法是
func (t *T) Read() []byte,则只有*T类型能赋给io.Reader接口 - 常见坑:
var t T; var r io.Reader = t编译失败,但var r io.Reader = &t可行
混用接收者?Go 虽自动转换,但别依赖它
Go 允许 t.Method() 调用指针接收者方法(自动转成 &t.Method()),前提是 t 是可寻址的变量。
立即学习“go语言免费学习笔记(深入)”;
- 不可寻址场景会报错:
Person{}.SetName("x")或make([]Person, 1)[0].SetName("x") - 更隐蔽的问题:嵌入结构体时,父结构体方法集不继承子结构体的指针方法
- 最佳实践:只要有一个方法用了
*T,其余全用*T—— 避免调用方猜“这个能不能改”
type Config struct {
Timeout int
Hosts []string
}
// ✅ 统一指针接收者,清晰、安全、可扩展
func (c *Config) SetTimeout(t int) { c.Timeout = t }
func (c *Config) AddHost(h string) { c.Hosts = append(c.Hosts, h) }
func (c *Config) String() string { return fmt.Sprintf("timeout=%d, hosts=%v", c.Timeout, c.Hosts) }
指针接收者不是性能优化技巧,而是语义契约:你声明“这个方法会改变我”。一旦破约,bug 就藏在调用链深处,而不是编译期。










