在Golang项目里，经常会遇到新代码期望使用某一标准接口，而遗留模块或第三方库暴露的方法签名却与之不同的情况。如果强行修改对方源码，不仅成本高，还会引入不稳定因素。适配器模式通过增加一层包装，让不兼容的接口能够协同工作，是结构型设计模式里非常实用的一种。
什么是适配器模式
适配器模式的核心思想是：将一个类的接口转换成客户希望的另一个接口，使得原本由于接口不兼容而不能一起工作的那些类可以一起工作。在传统的面向对象语言中，往往通过继承被适配者并实现目标接口来完成，也就是类适配器。但Golang没有继承机制，只有结构体嵌入与接口隐式实现，因此更常见的是对象适配器。
对象适配器做法很简单，定义一个适配器结构体，内部持有一个被适配对象的实例，然后让适配器结构体实现目标接口的方法，在方法内部调用被适配对象的原有方法并做必要的参数转换。这样做既保留了原对象的逻辑，又满足了新接口的契约，对调用方完全透明。
Golang中接口适配的基础写法
我们先定义一套项目内部期望的日志接口，以及一段已经存在的第三方日志实现。可以看到两者的方法名和参数完全不同，无法直接替换使用。
package main
import "fmt"
// 项目内部统一的日志接口
type Logger interface {
Info(msg string)
Error(msg string)
}
// 第三方旧日志库，只提供单一方法
type OldLogger struct{}
func (o *OldLogger) WriteLog(level int, content string) {
fmt.Printf("old logger [%d]: %sn", level, content)
}
上面代码中，Logger接口要求Info和Error两个方法，而OldLogger只有WriteLog，并且用整型level区分级别。为了让旧日志库接入新接口，我们写一个适配器。
// 适配器结构体，持有旧日志库实例
type LoggerAdapter struct {
old *OldLogger
}
// 实现Info方法，将调用转给旧库
func (a *LoggerAdapter) Info(msg string) {
a.old.WriteLog(1, msg)
}
// 实现Error方法，将调用转给旧库
func (a *LoggerAdapter) Error(msg string) {
a.old.WriteLog(2, msg)
}
LoggerAdapter实现了Logger接口的全部方法，在方法内部把字符串消息转换成了旧库需要的level加content形式。调用方只需要面向Logger接口编程，完全感知不到背后是旧库还是新库。
这种写法的优点在于符合开闭原则，对扩展开放、对修改关闭。旧代码一行没动，新代码通过组合方式接入。同时因为Golang接口是隐式实现的，LoggerAdapter不需要声明自己实现了Logger，只要方法集匹配即可，减少了耦合。
使用函数式适配器简化代码
如果被适配的逻辑非常轻量，为每一个旧类型都定义结构体略显啰嗦。我们可以利用Golang的函数类型来实现更紧凑的适配器。方法是定义一个函数类型并实现目标接口，把真正的调用逻辑通过闭包传进去。
// 用函数类型实现Logger接口
type FuncLogger func(level int, msg string)
func (f FuncLogger) Info(msg string) {
f(1, msg)
}
func (f FuncLogger) Error(msg string) {
f(2, msg)
}
// 将旧库方法适配为FuncLogger
func AdaptOldLogger(o *OldLogger) Logger {
return FuncLogger(func(level int, msg string) {
o.WriteLog(level, msg)
})
}
这里FuncLogger本身是一个函数签名，但它拥有了Info和Error方法，因此满足了Logger接口。AdaptOldLogger直接返回一个闭包包装的旧库调用，调用方拿到的是Logger类型，依旧无感知。
函数式适配器在适配层较薄时非常高效，避免了额外结构体定义。但如果适配过程包含状态保存或多种转换，还是推荐使用显式结构体，可读性更好，也方便后续扩展。
适配器模式的测试与维护优势
引入适配器后，业务代码只依赖Logger接口，因此在单元测试中可以轻松传入一个内存实现的假日志器，而不必启动旧库或第三方依赖。这显著提升了测试速度与稳定性。
// 测试用的内存日志器
type MemLogger struct {
Logs []string
}
func (m *MemLogger) Info(msg string) {
m.Logs = append(m.Logs, "INFO:"+msg)
}
func (m *MemLogger) Error(msg string) {
m.Logs = append(m.Logs, "ERROR:"+msg)
}
如上所示，MemLogger同样实现Logger，测试时直接替换即可。适配器将变化隔离在边界处，内部业务不受外部接口变动影响。当第三方库升级、方法签名改变时，只需调整适配器一处，不用动核心逻辑。
从长期维护看，适配器模式让系统边界更清晰。它虽然不是解决所有兼容问题的银弹，但在Golang这类强调小接口与组合的语言中，配合隐式接口特性，能够以极低的成本完成系统解耦与渐进式重构。
总结
在Golang中实现适配器模式，主要依靠结构体组合与接口隐式实现，既可采用对象适配器也可采用函数式适配器。核心都是让新定义类型拥有目标接口的方法集，并在内部委托原对象。实践时建议把适配代码放在包边界或基础设施层，避免污染领域逻辑。合理使用该模式，可以让遗留系统与新架构平稳共存。