Go中指针接收器和值接收器

Nse4u

已于 2025-05-02 11:20:13 修改

阅读量458

点赞数 3

CC 4.0 BY-SA版权

分类专栏： Go语言基础文章标签： golang 开发语言后端

于 2025-05-01 16:20:20 首次发布

本文链接：https://blog.csdn.net/A1561163756/article/details/147653105

Go语言基础专栏收录该内容

11 篇文章

订阅专栏

Go中指针接收器和值接收器

1. 内存与性能差异

特性	值接收器 ((s Struct))	指针接收器 ((s *Struct))
内存行为	每次调用复制整个结构体	仅传递指针（8字节，64位系统）
适用场景	小型结构体（< 3-4个字段）	中大型结构体或需要修改状态的场景

示例：

type Small struct { a int }
func (s Small) ValueMethod() {}  // 适合小结构体

type Large struct { data [1000]int }
func (l *Large) PtrMethod() {}   // 避免复制大内存块

2. 修改能力的区别

行为	值接收器	指针接收器
修改原结构体	❌ 操作的是副本	✅ 可直接修改原结构体
副作用	方法内的修改对外不可见	方法内的修改会影响原对象

示例：

type Counter struct {
    count int
}

func (c Counter) IncrByValue() { 
    c.count++ // 无效，修改的是副本
}

func (c *Counter) IncrByPointer() {
    c.count++ // 实际生效
}

// 使用：
c := Counter{}
c.IncrByValue()    // c.count 仍为 0
c.IncrByPointer()  // c.count 变为 1

3. 接口实现的差异

场景	值接收器	指针接收器
值类型调用接口	✅ 可赋值给接口变量	✅ 可赋值给接口变量
指针类型调用接口	❌ 不能赋值给接口变量（除非方法全是值接收器）	✅ 可赋值给接口变量

示例：

type Speaker interface { Speak() }

type Dog struct{}
func (d Dog) Speak() {}    // 值接收器

type Cat struct{}
func (c *Cat) Speak() {}   // 指针接收器

var s Speaker
s = Dog{}       // 合法
s = &Dog{}      // 也合法（Go自动解引用）

s = Cat{}       // ❌ 非法！
s = &Cat{}      // 合法

4. 并发安全性的影响

接收器类型并发调用特性
值接收器天然线程安全（每次调用操作独立副本）
指针接收器需要手动加锁保护
指针接收器的并发示例：

type Account struct {
    balance int
    sync.Mutex
}

func (a *Account) Deposit(amount int) {
    a.Lock()
    defer a.Unlock()
    a.balance += amount
}

5. Go-Zero 中的实践

在 Go-Zero 生成的代码中，统一使用指针接收器，原因包括：

性能考量：Logic 结构体通常携带请求上下文（如 svcCtx），复制开销大
状态共享：需要修改中间件链或日志记录器状态
框架一致性：避免混合使用导致的行为差异

典型 Go-Zero 代码：

func (l *UserLogic) GetUser(req *types.Request) (*types.Response, error) {
    // 访问服务容器（必须通过指针共享）
    db := l.svcCtx.DB 
    // ...
}

选择指南

使用值接收器当	使用指针接收器当
结构体很小（< 100字节）	结构体较大或包含引用类型（如切片、map）
不需要修改原结构体	需要修改接收器状态
要求天然并发安全	需要共享或持久化状态
实现标准库接口（如 fmt.Stringer）	实现业务逻辑接口（如 Go-Zero 的 Handler）

总结对比表

维度	值接收器 (Struct)	指针接收器 (*Struct)
内存使用	复制整个结构体	只传递指针
修改能力	仅操作副本	可修改原对象
接口兼容性	值/指针调用皆可	仅指针调用合法
线程安全	安全	需加锁
典型应用场景	不可变小对象	需要状态管理的服务/控制器