Go适配器核心是解决接口不兼容问题，必须严格匹配方法签名；嵌入易致panic和契约破坏，应显式字段+转发；参数/返回值差异需安全转换；多实现用注册表管理；单方法接口优先函数适配器，但不可携带状态。
Go 里写适配器，不是为了“设计得漂亮”，而是为了让你手上的两个接口能互相传参、不报 cannot use ... as type ... 错误——只要签名差一个字、少一个 context.Context、返回值顺序颠倒，编译器就直接拒绝。
为什么嵌入原类型反而容易出错
很多人一上来就写 type Adapter struct{ *LegacyClient }，以为能自动透传所有方法。但问题在于：
- 如果
LegacyClient的方法用的是指针接收者（func (c *LegacyClient) Do()），而你嵌入的是值类型LegacyClient（不是*LegacyClient），那这些方法根本不会被提升 - 嵌入后会意外暴露原类型所有公开方法，比如
Adapter.Close()实际调的是LegacyClient.Close()，但你的目标接口根本没定义Close，这破坏了接口契约 - 字段未初始化时直接调用会 panic：若
LegacyClient字段为nil，而你又没在构造函数里校验，a.Do()就直接崩
正确做法是显式声明私有字段：legacy *LegacyClient，不嵌入，只在方法里转发调用。
参数/返回值不一致时怎么安全转换
常见场景：老接口 Get(string) (string, error)，新接口要求 Fetch(context.Context, string) ([]byte, error)。这时不能硬套，必须显式处理差异：
立即学习“go语言免费学习笔记（深入）”；
-
context.Context不能丢——哪怕老实现不支持，也得明确降级：ctx = ctx // 或 fallback to context.Background()，不能静默忽略 - 返回类型转换要保留错误语义：
return []byte(s), err没问题，但若老接口返回error是*json.SyntaxError，而新接口下游只认errors.Is(err, ErrParse)，就得做错误映射 - 参数名或顺序不同（如
Put(key, value string)vsSet(value, key string)）必须在适配器方法体内重排，别指望编译器帮你猜
示例：func (a *APIAdapter) Fetch(ctx context.Context, url string) ([]byte, error) { s, err := a.legacy.Get(url); return []byte(s), err }
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
多个第三方实现共存时怎么避免 if-else 堆砌
当你要同时支持 aws-sdk-go、minio-go 和本地文件系统时，别写 if provider == "aws" { return &AWSAdapter{...} } 这种逻辑：
- 每加一个新 provider 就要改工厂函数，违反开闭原则
- 类型判断依赖字符串，拼错就 panic，且无法静态检查
- map 默认非并发安全，若注册发生在运行时且多 goroutine 写入，会 crash
推荐用注册表 + 工厂函数：
var fetchers = make(map[string]func() Fetcher)
func Register(name string, ctor func() Fetcher) {
fetchers[name] = ctor
}
func NewFetcher(name string) Fetcher {
ctor, ok := fetchers[name]
if !ok {
panic("unknown fetcher: " + name)
}
return ctor()
}
注册键用配置项名（如 "s3"、"minio"），不是类型名；初始化阶段完成注册，运行时只读即可。
函数类型适配器的适用边界
只有当目标接口只有一个方法，且逻辑纯粹是参数重命名或类型转换时，才考虑用函数类型：
- 例如
type Handler interface{ ServeHTTP(http.ResponseWriter, *http.Request) }，标准库已提供http.HandlerFunc作为适配器 - 你自己定义：
type Doer func(string) error，再让func(f Doer) Do(s string) error { return f(s) }实现某个单方法接口 - 但一旦接口增加第二个方法（比如
Close() error），函数类型立刻失效，必须切回 struct - 函数适配器无法携带状态（如 client 实例、配置、连接池），所有依赖都得靠闭包捕获，测试和复用性差
别为了省几行代码把 struct 强转成函数——Go 不允许 interface{} 自动满足接口，也不支持函数到结构体的隐式转换。
最常被跳过的一步：适配器里不做超时控制、不加锁、不重试、不打日志。它只负责翻译协议，其余交给上层中间件或调用方。一旦掺杂业务逻辑，下次换实现时就得重写整个适配器，而不是只换一个 struct。
