Go语言如何实现适配器模式_Go语言适配器模式教程【实战】-Golang-PHP中文网

go适配器模式用嵌入+方法委托实现轻量接口转换，只覆盖不匹配方法，需防nil嵌入、context丢失、error未包装三类panic，并通过注册表管理多源适配。

go语言如何实现适配器模式_go语言适配器模式教程【实战】

Go 里没有“继承”和“抽象类”，所谓适配器模式，就是用结构体字段 + 方法委托，把一个已有类型“包一层”，让它满足另一个接口——前提是：你手上已经有两个不兼容的接口，又不能改对方代码。

用嵌入+方法委托实现最轻量适配

别写空壳 struct 再手动实现所有方法。Go 的匿名字段天然支持方法提升，直接嵌入原类型，只覆盖签名不一致或缺失的方法即可。

type ThirdPartyLogger struct{} 提供 Write(msg string, level int)
type Logger interface{ Log(message string) } 是你业务要求的接口
type LoggerAdapter struct{ *ThirdPartyLogger } —— 匿名嵌入，自动获得 Write 方法
只需显式实现 Log：func (a *LoggerAdapter) Log(msg string) { a.Write(msg, 1) }

如果目标接口比原类型多一个方法，就只实现那一个；其余全部透传。硬编码全量方法体是反模式。

注意三个容易 panic 的地方

适配器不是透明管道，三个位置不校验就会在运行时崩：

嵌入字段为 nil 时调用方法直接 panic —— 构造函数里必须加 if src == nil { panic("nil source") }
原接口接收 context.Context，但目标接口没暴露 —— 别丢 context，要么用 context.Background() 显式降级，要么推动目标接口升级（需协同）
错误返回位置/类型不一致（比如原方法返回 (int, error)，目标要 error）—— 必须显式包装：return fmt.Errorf("wrap: %w", err)，别裸 return

多个来源时别 if-else，用注册表+工厂

当要适配 "aws-s3"、"minio"、"localfs" 多种后端时，硬编码判断类型再 new 适配器会迅速腐化。

Go语言（Golang）1.26.0

Go语言（Golang）1.26.0版本官方下载，版本号 1.26.0，适合旧项目维护、兼容性测试和指定版本开发环境搭建。

下载

定义注册表：var adapters = make(map[string]func() Fetcher)
注册构造函数：adapters["aws-s3"] = func() Fetcher { return &S3Adapter{client: newS3Client()} }
使用时查表：factory := adapters[config.Provider]; if factory == nil { panic("unknown provider") }

键名用配置项（如 "aws-s3"），别用 reflect.TypeOf，否则耦合反射且不可配置。

标准库里的真实例子：http.HandlerFunc

它不是语法糖，就是一个典型适配器：type HandlerFunc func(http.ResponseWriter, *http.Request) 是函数类型，而 http.Handler 是接口，要求实现 ServeHTTP 方法。

func (f HandlerFunc) ServeHTTP(w http.ResponseWriter, r *http.Request) { f(w, r) } —— 就这一行，把普通函数“转成”了接口。你写的每个 http.HandleFunc("/", handler)，背后都是这个适配器在起作用。

真正难的从来不是怎么写适配器，而是识别出哪里该切一刀：那个“不能改”的第三方类型，和那个“必须满足”的业务接口，中间差的那一层转换逻辑，才是关键。漏掉 context 或 error 包装，上线后第一波压测就可能暴露。