Go / 系统课时
给自定义类型定义方法
给自定义类型定义方法
Go 的方法把行为绑定到命名类型上。关键不是语法本身,而是接收者的选择:值接收者会得到一份值的副本,指针接收者可以修改原对象,并且两者会直接影响方法集与接口实现。本篇用可运行示例把这三件事连起来。
学习目标
- 为结构体和其他命名类型声明方法,并正确调用
- 根据“是否修改状态、是否避免复制”选择值接收者或指针接收者
- 根据方法集判断
T与*T是否满足某个接口
在命名类型上声明方法
方法的语法是在 func 与方法名之间增加接收者。接收者类型必须是当前包中定义的命名类型;它既可以是结构体,也可以是 type Celsius float64 这样的自定义基础类型。
下面的程序同时演示普通命名类型、值接收者和指针接收者:
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)
}预期输出:
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 实现,就明确使用指针接收者,并用编译期断言固定预期的方法集。