Go / 系统课时

给自定义类型定义方法

给自定义类型定义方法

Go 的方法把行为绑定到命名类型上。关键不是语法本身,而是接收者的选择:值接收者会得到一份值的副本,指针接收者可以修改原对象,并且两者会直接影响方法集与接口实现。本篇用可运行示例把这三件事连起来。

学习目标

  • 为结构体和其他命名类型声明方法,并正确调用
  • 根据“是否修改状态、是否避免复制”选择值接收者或指针接收者
  • 根据方法集判断 T 与 *T 是否满足某个接口

在命名类型上声明方法

方法的语法是在 func 与方法名之间增加接收者。接收者类型必须是当前包中定义的命名类型;它既可以是结构体,也可以是 type Celsius float64 这样的自定义基础类型。

下面的程序同时演示普通命名类型、值接收者和指针接收者:

go
package main

import "fmt"

type Celsius float64

func (c Celsius) Fahrenheit() float64 {
	return float64(c)*9/5 + 32
}

type Account struct {
	Owner   string
	Balance int
}

func (a Account) Label() string {
	return fmt.Sprintf("%s:%d", a.Owner, a.Balance)
}

func (a Account) PreviewDeposit(amount int) int {
	a.Balance += amount // 只修改接收者副本
	return a.Balance
}

func (a *Account) Deposit(amount int) {
	a.Balance += amount // 修改原对象
}

type Depositor interface {
	Deposit(int)
}

var _ Depositor = (*Account)(nil)

func main() {
	temp := Celsius(20)
	fmt.Printf("%.1f F\n", temp.Fahrenheit())

	acc := Account{Owner: "Lin", Balance: 100}
	fmt.Println(acc.Label())
	fmt.Println("preview:", acc.PreviewDeposit(50))
	fmt.Println("after preview:", acc.Balance)

	acc.Deposit(50)
	fmt.Println("after deposit:", acc.Balance)
}

预期输出:

text
68.0 F
Lin:100
preview: 150
after preview: 100
after deposit: 150

这里的 Celsius 说明方法并不要求接收者是结构体;只要是当前包声明的命名类型即可。PreviewDeposit 内部看到的 a 是副本,因此返回 150 后,外部 acc.Balance 仍是 100;Deposit 接收 *Account,所以余额真正变为 150。

选择值接收者还是指针接收者

选择时先看语义,再看性能。需要修改接收者时必须使用指针接收者;较大的结构体通常也优先用指针,避免每次调用都复制整个值。不可变的小值类型,例如 time.Duration 风格的数值包装类型,值接收者通常更自然。

可以按下面的规则检查:

情况 推荐
方法需要修改字段 *T
结构体较大,复制成本明显 *T
类型本质上表示小型值对象,不修改自身 T
同一类型多数方法已使用指针接收者 保持 *T 一致

不要仅因为调用写成 acc.Deposit(50) 就认为这是值接收者。只要 acc 是可寻址变量,编译器可以把这类调用理解为对 &acc 调用指针接收者方法;但这不改变方法集规则。

方法集如何影响接口实现

对命名类型 T,方法集可以简化为两条:T 只包含接收者为 T 的方法;*T 同时包含接收者为 T 和 *T 的方法。示例中的 Deposit 接收 *Account,因此只有 *Account 满足 Depositor。

值类型与指针类型的方法集关系

示例中的编译期断言 var _ Depositor = (*Account)(nil) 不会创建真实对象,也不会运行任何逻辑;它只要求编译器确认 *Account 实现了 Depositor。如果改成 var _ Depositor = Account{},编译会因 Account 的方法集中没有 Deposit 而失败。

避免接收者选择带来的隐蔽问题

同一类型的方法最好统一接收者风格。若一半方法使用 T、另一半使用 *T,调用表面上往往仍能工作,但接口赋值时更容易出现“变量能调用,类型却不满足接口”的困惑。

另一个边界是 nil 指针接收者。var p *Account = nil 仍然拥有 Deposit 方法,但方法体一旦访问 a.Balance 就会触发运行时 panic。除非类型明确设计了 nil 语义,否则不要把 nil 接收者当成正常状态传递。

当方法只读取一个小型值时使用值接收者;一旦涉及修改状态、较大对象或需要让接口由 *T 实现,就明确使用指针接收者,并用编译期断言固定预期的方法集。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

给自定义类型定义方法

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通