在Golang开发过程中，我们经常会遇到这样的场景：已有的功能模块实现了某个接口，但是当前业务需要的目标接口和这个已有接口的方法定义不一致，直接调用会出现兼容问题。这时候使用适配器模式就能很好地解决这个问题，通过新增适配器结构来桥接两个不兼容的接口，让原本无法一起工作的类可以协同工作。
适配器模式的核心思想
适配器模式属于结构型设计模式的一种，核心作用是把一个类的接口转换成客户端期望的另一个接口。在Golang中，因为接口是隐式实现的，所以适配器的实现会更加灵活，不需要显式声明实现了某个接口，只要方法签名匹配即可。
适配器模式主要包含三个角色：
- 目标接口：客户端期望使用的接口，也就是我们需要适配到的接口
- 适配者：已经存在的、接口和目标接口不匹配的类或接口
- 适配器：连接目标接口和适配者的中间结构，实现了目标接口，内部持有适配者的实例，在目标接口的方法中调用适配者的对应方法完成功能
Golang实现适配器模式的步骤
1. 定义目标接口
首先我们需要明确客户端需要使用的目标接口，假设我们有一个支付场景，目标接口要求有Pay方法，接收金额参数并返回支付结果。
// 目标接口：客户端期望使用的支付接口
type PaymentTarget interface {
Pay(amount float64) string
}
2. 定义适配者接口或结构
假设我们已经有一个旧的支付系统，它的接口定义和我们的目标接口不一致，旧系统的支付方法叫OldPay，接收的是整数类型的金额，并且返回的是状态码。
// 适配者：已有的旧支付系统
type OldPayment struct{}
// 旧支付系统的支付方法，接收整数金额，返回状态码
func (o *OldPayment) OldPay(amount int) int {
if amount > 0 {
return 1 // 1表示支付成功
}
return 0 // 0表示支付失败
}
3. 实现适配器结构
接下来我们创建适配器，适配器需要实现目标接口PaymentTarget，同时内部持有适配者OldPayment的实例，在Pay方法中调用OldPay方法，完成参数转换和结果适配。
// 适配器：桥接目标接口和适配者
type PaymentAdapter struct {
oldPayment *OldPayment // 持有适配者的实例
}
// 实现目标接口的Pay方法
func (p *PaymentAdapter) Pay(amount float64) string {
// 将float64金额转换为旧系统需要的int类型
intAmount := int(amount)
// 调用旧系统的支付方法
code := p.oldPayment.OldPay(intAmount)
// 将旧系统的返回状态码转换为目标接口的返回格式
if code == 1 {
return "支付成功"
}
return "支付失败"
}
4. 客户端调用验证
最后我们可以在客户端中使用适配器来完成支付操作，客户端只需要面向目标接口编程，不需要关心旧系统的接口细节。
package main
import "fmt"
func main() {
// 创建旧支付系统实例
oldPay := &OldPayment{}
// 创建适配器，传入旧支付系统实例
adapter := &PaymentAdapter{oldPayment: oldPay}
// 客户端面向目标接口调用，不需要关心旧系统的实现
result := adapter.Pay(100.5)
fmt.Println(result) // 输出：支付成功
result = adapter.Pay(-10)
fmt.Println(result) // 输出：支付失败
}
适配器模式的注意事项
在Golang中使用适配器模式时，需要注意以下几点：
- 适配器模式会增加系统的复杂度，如果只是偶尔出现的接口不兼容问题，不建议过度使用，避免引入不必要的结构
- 适配器的核心工作是做接口转换，尽量不要在适配器中添加额外的业务逻辑，保证适配器的职责单一
- 因为Golang的接口是隐式实现的，所以适配器只要方法签名和目标接口一致，就会被识别为实现了目标接口，不需要显式声明
- 如果适配者和目标接口的方法差异过大，可能需要多个适配器或者组合使用其他设计模式来完成适配
常见应用场景
适配器模式在Golang项目中的常见使用场景包括：
- 旧系统升级时，新接口和旧接口不兼容，用适配器兼容旧逻辑
- 引入第三方库时，第三方库的接口和项目现有接口不匹配，通过适配器统一接口规范
- 多个类似功能但接口不同的模块需要统一调用方式时，为每个模块编写适配器，让客户端可以统一面向同一个接口编程
适配器模式的核心价值是解耦客户端和适配者，让客户端不需要修改原有代码就能使用不兼容的接口，提升代码的复用性和可维护性。
Golang适配器模式接口兼容设计模式go_adapter修改时间：2026-07-18 10:48:24