适配器模式解决已有类型不满足新接口要求但逻辑不可重写的兼容问题；Go中通过组合（嵌入）或函数值绑定实现接口转换，仅做最小必要适配，不引入业务逻辑或状态。
适配器模式解决的是什么接口兼容问题
Go 里没有传统 OOP 的“继承”和“类”，所以适配器不是靠子类重写方法，而是靠组合 + 接口转换。核心场景就一个：已有类型不满足新接口要求，但逻辑又不想重写。比如你拿到一个第三方库的 LegacyLogger，它只有 Log(string) 方法，而你的系统统一依赖 Logger 接口：
type Logger interface {
Info(msg string)
Error(msg string)
Debug(msg string)
}这时直接传 LegacyLogger 会编译报错：LegacyLogger does not implement Logger (missing Info, Error, Debug methods)。
用嵌入+方法转发实现轻量适配器
最常用、最 Go 风格的做法是定义一个新类型，内嵌原类型，再为缺失方法提供转发或适配逻辑：
type LegacyLoggerAdapter struct {
*LegacyLogger // 嵌入，复用 Log 方法
}
func (a *LegacyLoggerAdapter) Info(msg string) {
a.Log("[INFO] " + msg)
}
func (a *LegacyLoggerAdapter) Error(msg string) {
a.Log("[ERROR] " + msg)
}
func (a *LegacyLoggerAdapter) Debug(msg string) {
a.Log("[DEBUG] " + msg)
}
关键点：
- 嵌入
*LegacyLogger后，LegacyLoggerAdapter自动获得其所有导出方法（如Log），避免重复封装 - 每个适配方法只做最小转换：加前缀、改参数顺序、忽略某些字段，不引入额外状态或缓存
- 返回值必须严格匹配目标接口——如果
Logger.Info返回error，那适配器里也得补上return nil或真实错误处理 - 不要在适配器里做日志级别过滤（比如把
Debug直接丢弃），那是调用方或配置层的事，适配器只负责“能调通”
函数适配器：当原类型连方法都没有时
有些老代码只有独立函数，比如：
func WriteToDisk(content string) error { ... }而你需要满足 Writer 接口：type Writer interface {
Write([]byte) (int, error)
}这时没法嵌入，得用函数值构造适配器：
type FuncWriter func([]byte) (int, error)
func (f FuncWriter) Write(p []byte) (int, error) {
return f(p)
}
// 使用：
writer := FuncWriter(func(b []byte) (int, error) {
return WriteToDisk(string(b))
})
注意：
-
FuncWriter是类型别名 + 方法绑定，不是闭包本身；闭包写在初始化位置更清晰 - 如果原函数签名参数不匹配（比如要
string，接口要[]byte），转换逻辑必须显式写出，不能靠类型自动转换 - 这种适配器无法访问原函数的内部状态（比如文件句柄），如有需要，得包装成结构体并保存依赖
容易被忽略的边界：nil 指针与空接口传递
适配器类型本身是新类型，哪怕底层嵌入了非空值，它仍可能为 nil。如果适配器方法里直接解引用嵌入字段，运行时 panic：
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
func (a *LegacyLoggerAdapter) Info(msg string) {
a.Log("[INFO] " + msg) // 如果 a == nil，这里 panic
}
正确做法是检查嵌入字段是否为 nil，或确保构造时强制非空：
- 导出构造函数，禁止字面量直接初始化：
func NewLegacyLoggerAdapter(l *LegacyLogger) *LegacyLoggerAdapter { if l == nil { panic("LegacyLogger cannot be nil") } return &LegacyLoggerAdapter{l} } - 或者在每个方法开头 guard：
if a.LegacyLogger == nil { return } - 更隐蔽的问题：把适配器传给接受
interface{}的函数（比如日志中间件），再反射调用方法——Go 不会自动解包嵌入字段，必须确保接收方按适配器类型接收
接口兼容的本质不是“看起来像”，而是“调用时不崩溃、语义不歪曲”。适配器越薄越好，一旦开始在其中做业务判断或格式重组，就该考虑重构原类型或引入中间层了。
