Go适配器模式通过组合与接口转换实现,而非继承;适用于无法修改第三方/遗留代码但需匹配自定义接口的场景,核心是包装行为、转换接口形状。
Go 语言没有接口继承和类继承,所以适配器模式不是靠「让类实现某接口」来硬套,而是靠组合 + 接口转换来达成目标。核心在于:把一个已有类型的行为,包装成另一个接口所期望的形状。
什么时候该用 Adapter 而不是直接改原类型
常见于对接第三方库、遗留代码或标准库时——你无法修改对方源码,但又需要它符合你当前系统定义的接口。比如:
- 标准库的
http.ResponseWriter不满足你自定义的Writer接口(比如多了StatusCode()方法) - 某个 SDK 返回的
DBClient只有Exec()和Query(),而你的业务层依赖的是DataStore接口(含BeginTx(),Close()) - 测试中想把
*bytes.Buffer当作实现了io.ReadCloser的对象用,但它没实现Close()
最简适配器:嵌入 + 方法转发
这是最轻量、最 Go 风格的做法。不新增结构体字段,只通过嵌入已有类型,并补全缺失方法:
// 假设你有这个接口
type DataWriter interface {
Write(data []byte) error
Close() error
}
// 第三方类型(你不能改)
type LegacyWriter struct{}
func (l *LegacyWriter) Write(data []byte) error {
// 实际写逻辑
return nil
}
// 适配器:嵌入 + 补 Close
type LegacyWriterAdapter struct {
*LegacyWriter
}
func (a *LegacyWriterAdapter) Close() error {
// 可以是空实现、日志、资源清理等
return nil
}
注意:*LegacyWriterAdapter 现在能赋值给 DataWriter 接口变量。这种写法干净、零分配、无中间层开销。
带状态的适配器:显式字段 + 组合
当适配逻辑需要额外状态(如缓存、配置、上下文),就不能只靠嵌入了。必须显式持有被适配对象,并手动实现所有接口方法: