适配器模式（Adapter Pattern）
非常好的问题！适配器模式（Adapter Pattern）是结构型设计模式之一，用于解决“接口不兼容”但又必须协作的问题。我将用通俗的例子 + 详细注释的 Python 代码 + 清晰的类图/流程图来讲明白。
🧠 一句话解释
适配器模式用于将一个类的接口转换成客户端期望的另一个接口，使原本接口不兼容的类可以协同工作。
🎯 生活类比
你买了一个欧标插头的吹风机（两圆孔），但你住的地方是国标插座（三扁孔）…
✅ 你不能改吹风机
✅ 也不能换房子
你需要的就是 —— 一个“插头适配器”
✅ 为什么需要适配器模式？
| 问题 | 适配器的作用 |
|---|---|
| 第三方类或旧类接口不一致 | 做接口转换 |
| 系统需要复用旧代码，但旧接口不兼容 | 用适配器包装老接口 |
| 提高代码灵活性、解耦 | 不修改源类也能集成使用 |
🧩 场景示例：我们有一个第三方的音频播放器类，但它接口叫 play_music()；而我们的系统统一调用 play()。
我们希望能让这个类“假装”实现了我们的接口。
✅ Python 完整示例：音频播放器适配器
🎧 第三方类（无法修改）
# 第三方音频类，方法名不符合我们系统的接口
class ThirdPartyAudio:def play_music(self, file):print(f"🎵 正在用第三方播放器播放: {file}")
🎯 目标接口（我们的系统期望的接口）
# 我们系统中统一接口：所有播放器必须有 play(file) 方法
class MediaPlayer:def play(self, file):raise NotImplementedError
🔌 适配器类：将 play() 转为 play_music()
class AudioAdapter(MediaPlayer):def __init__(self, third_party_audio):self.audio = third_party_audio # 内部使用不兼容的对象def play(self, file):# 转换接口self.audio.play_music(file)
🧪 客户端代码：统一调用 play() 即可
def client_code(player: MediaPlayer, filename: str):player.play(filename)# 用第三方播放器，但对外接口是统一的
third_party = ThirdPartyAudio()
adapter = AudioAdapter(third_party)client_code(adapter, "热爱105°C的你.mp3")
✅ 输出结果：
🎵 正在用第三方播放器播放: 热爱105°C的你.mp3
🧭 类图（Mermaid）
✅ 优点 vs ❌ 缺点
| 优点 | 缺点 |
|---|---|
| ✅ 解耦：不改原有代码 | ❌ 增加类的数量 |
| ✅ 兼容旧系统或第三方 | ❌ 有时会隐藏接口设计缺陷 |
| ✅ 封装灵活，可替换 | ❌ 多层适配会增加复杂度 |
🧠 应用场景
| 应用 | 示例 |
|---|---|
| 系统整合 | 接入旧系统、数据库、第三方API |
| UI适配 | 统一控件接口（如 Qt、Tkinter） |
| 桥接系统变更 | 替换新模块，保留旧接口 |
🧠 总结口诀
原类接口无法动，目标接口不能改，插个适配器，两边都能嗨！
是否需要我帮你将这个例子换成你更熟悉的领域，比如：
- 第三方支付系统（如 Alipay 接口适配成统一的 Pay 接口）
- 图像处理库 PIL vs OpenCV 的转换适配
- Excel 表格 vs pandas DataFrame 的适配器封装
我可以按你习惯的项目来举例演示 😄 是否继续？