Go Academy · 课时

方法中的指针接收者

Q: 「方法中的指针接收者」这节课中我会学到什么？

通过指针接收者修改结构体状态 你通过在浏览器中直接运行的动手代码来练习 Go Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

通过指针接收者修改结构体状态

方法中的指针接收者 是 CoddyKit 上的免费 Go Academy 课时。这是第 3 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Go Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Go Academy 课程共包含 4 节课。

回顾：值接收者与指针接收者

值接收者操作的是结构体的副本。指针接收者操作的是原始结构体。只要方法需要修改状态，就应使用指针接收者。

使用指针接收者进行修改

只有指针接收者才能修改结构体：

package main
import "fmt"

type Stack struct{ items []int }

func (s *Stack) Push(v int) { s.items = append(s.items, v) }
func (s *Stack) Pop() int {
    n := len(s.items) - 1
    v := s.items[n]
    s.items = s.items[:n]
    return v
}

func main() {
    var st Stack
    st.Push(1); st.Push(2)
    fmt.Println(st.Pop()) // 2
}

一致性规则

如果某个类型的方法需要使用指针接收者，那么所有方法都应使用指针接收者。混用会导致接口满足方面的问题：

package main
import "fmt"

type Counter struct{ n int }

func (c *Counter) Inc()   { c.n++ }   // pointer
func (c *Counter) Val() int { return c.n } // pointer too

func main() {
    c := &Counter{}
    c.Inc(); c.Inc()
    fmt.Println(c.Val()) // 2
}

满足接口

指针接收者方法只属于 *T 的方法集，而不属于 T 的方法集。这会影响接口满足：

package main
import "fmt"

type Writer interface{ Write([]byte) }

type File struct{ name string }
func (f *File) Write(b []byte) { fmt.Println(string(b)) }

func main() {
    var w Writer = &File{"out.txt"} // OK
    // var w Writer = File{} — compile error
    w.Write([]byte("hello"))
}

自动获取地址

在可寻址值上调用指针接收者方法时，Go 会自动获取该值的地址：

package main
import "fmt"

type Box struct{ V int }
func (b *Box) Double() { b.V *= 2 }

func main() {
    b := Box{5}
    b.Double()          // Go does (&b).Double()
    fmt.Println(b.V)    // 10
}

不可寻址的值

您不能在不可寻址的值上调用指针接收者方法（例如映射元素，以及未赋值给变量的函数返回值）：

package main

type T struct{ V int }
func (t *T) Set(v int) { t.V = v }

func getT() T { return T{} }

func main() {
    var t T
    t.Set(1)       // OK — t is addressable
    // getT().Set(1) — ERROR: cannot take address of getT()
    _ = t
}

大型结构体的接收者

对于大型结构体，应始终使用指针接收者，以避免每次调用方法时都进行代价高昂的复制：

package main

type Image struct{ pixels [1024][1024]uint8 }

// Value receiver copies 1MB per call!
func (img Image) Bad() uint8 { return img.pixels[0][0] }

// Pointer receiver — zero copy
func (img *Image) Good() uint8 { return img.pixels[0][0] }

func main() { _ = Image{} }

nil 指针接收者

使用指针接收者的方法可以妥善处理 nil：

package main
import "fmt"

type List struct{ head *node }
type node struct{ val int; next *node }

func (l *List) Len() int {
    if l == nil { return 0 }
    count := 0
    for n := l.head; n != nil; n = n.next { count++ }
    return count
}

func main() {
    var l *List
    fmt.Println(l.Len()) // 0
}

嵌入与指针接收者

嵌入带有指针接收者的类型时，外层结构体也必须作为指针使用，才能获得提升的方法：

package main
import "fmt"

type Base struct{ V int }
func (b *Base) Set(v int) { b.V = v }

type Derived struct{ Base }

func main() {
    d := &Derived{}
    d.Set(42)           // promoted pointer-receiver method
    fmt.Println(d.V)    // 42
}

复制互斥锁

绝不要复制包含 sync.Mutex 的结构体——始终使用指针接收者或通过指针传递。复制已加锁的互斥锁会导致死锁：

package main
import "sync"

type Safe struct {
    mu sync.Mutex
    v  int
}

// Correct: pointer receiver
func (s *Safe) Set(v int) {
    s.mu.Lock()
    defer s.mu.Unlock()
    s.v = v
}

func main() { _ = Safe{} }

go vet 可检测错误

运行 go vet ./...，以捕获常见的指针接收者错误，例如复制互斥锁和锁。它是 go build 流水线和 CI 检查的一部分。

快速检查

指针接收者方法属于哪些类型的方法集？

回顾

要点：

指针接收者可以修改值；值接收者不能
同一个类型的所有方法都使用相同种类的接收者
只有 *T 能满足要求包含指针接收者方法的接口
绝不要复制带有互斥锁的结构体——使用指针接收者

练习提示

实现一个 Queue 结构体，使用指针接收者实现 Enqueue(int)、Dequeue() (int, bool) 和 Len() int 方法，并以 []int 切片作为底层存储。

常见问题解答

「方法中的指针接收者」课时是免费的吗？

是的 — 「方法中的指针接收者」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Go Academy 课程的其余内容，请升级到 CoddyKit PRO。 Go Academy 课程共包含 4 节课。

「方法中的指针接收者」这节课中我会学到什么？

通过指针接收者修改结构体状态你通过在浏览器中直接运行的动手代码来练习 Go Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Go Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Go Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 3 节课，共 4 节。

「方法中的指针接收者」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Go Academy 课中编写并运行代码吗？

能。每节 Go Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 Go Academy