Go / 系统课时
用接口隔离调用方与实现
用接口隔离调用方与实现
Go 接口适合放在“调用方需要什么能力”的位置,而不是为具体类型建立继承层次。调用方只依赖少量方法后,真实实现、内存假对象和后续替换实现都能通过同一入口接入,而且具体类型无需写任何 implements 声明。
学习目标
- 定义职责单一的小接口,并让具体类型隐式满足它
- 让业务代码依赖接口而不是具体实现
- 用第二个实现验证接口确实降低了替换和测试成本
从调用方需要的能力定义接口
假设订单完成后需要发送通知。业务层真正需要的只有“发送一条消息”,因此接口只保留一个 Notify 方法,不暴露具体实现的配置字段或辅助方法。
下面是一个完整可运行示例:
package main
import "fmt"
type Notifier interface {
Notify(user, message string) error
}
type ConsoleNotifier struct{}
func (ConsoleNotifier) Notify(user, message string) error {
fmt.Printf("send to %s: %s\n", user, message)
return nil
}
type MemoryNotifier struct {
Messages []string
}
func (m *MemoryNotifier) Notify(user, message string) error {
m.Messages = append(m.Messages, user+"="+message)
return nil
}
type OrderService struct {
notifier Notifier
}
func NewOrderService(n Notifier) *OrderService {
return &OrderService{notifier: n}
}
func (s *OrderService) Complete(orderID, user string) error {
if err := s.notifier.Notify(user, "order "+orderID+" paid"); err != nil {
return err
}
return nil
}
var _ Notifier = ConsoleNotifier{}
var _ Notifier = (*MemoryNotifier)(nil)
func main() {
prod := NewOrderService(ConsoleNotifier{})
_ = prod.Complete("ORD-42", "lin")
fake := &MemoryNotifier{}
testSvc := NewOrderService(fake)
_ = testSvc.Complete("ORD-99", "test-user")
fmt.Println(fake.Messages)
}预期输出:
send to lin: order ORD-42 paid
[test-user=order ORD-99 paid]OrderService 没有导入或保存 ConsoleNotifier,只保存 Notifier。因此生产代码可以传控制台实现,测试代码可以传 MemoryNotifier,业务方法本身无需修改。
接口满足是隐式发生的
Go 不要求类型声明“实现了哪个接口”。只要方法集完整匹配,类型就满足接口。示例里 ConsoleNotifier 的 Notify 是值接收者,所以 ConsoleNotifier 和 *ConsoleNotifier 都能满足 Notifier;MemoryNotifier 的方法使用指针接收者,因此是 *MemoryNotifier 满足接口。
两条编译期断言把这种关系写死在代码里:
var _ Notifier = ConsoleNotifier{}检查值类型是否满足接口。var _ Notifier = (*MemoryNotifier)(nil)检查指针类型是否满足接口。
如果把 Notify 的参数从 message string 改成 message []byte,而接口仍要求 string,断言所在行会直接编译失败,问题不会拖到运行期。
用依赖注入隔离调用方
把接口作为构造函数参数,是 Go 中常见且足够轻量的依赖注入方式。调用关系可以拆成“业务代码依赖能力,外部负责选择实现”,这样 OrderService 不需要知道通知最终写到终端、HTTP API 还是消息队列。

这种结构最适合边界依赖,例如存储、通知、时间、随机数、外部 HTTP 客户端。若业务代码直接在 Complete 内创建 ConsoleNotifier{},测试时就无法替换它;把选择实现的动作移到 main 或构造函数后,调用方只保留真正需要的能力。
控制接口大小与放置位置
接口越大,实现成本越高,也越容易把调用方绑到不需要的能力上。若 OrderService 只发送通知,就不要把 Close、HealthCheck、Metrics 等方法一起塞进 Notifier。一个只含 1~3 个方法的消费方接口,通常更容易替换和测试。
接口通常定义在使用它的包附近,而不是实现类型所在的包。这样接口描述的是调用方契约,而不是实现方自我声明。标准库中的 io.Reader 只有 Read(p []byte) (n int, err error) 一个方法,就是“小接口”最典型的形式。
还要注意 typed nil:当一个 *MemoryNotifier 为 nil 后再赋给 Notifier,接口值本身可能不等于 nil,因为它仍保存动态类型 *MemoryNotifier。如果 Notify 内部访问字段,就可能 panic。构造服务时应传入真实可用的实现,而不是把带动态类型的 nil 指针当作“没有依赖”。
当调用方只依赖自己真正使用的方法,并由外部注入具体实现时,替换实现、编写测试和控制包依赖都会直接变简单;接口的价值来自这个依赖边界,而不是接口数量本身。