设计模式 是做什么的?
一份基于《深入设计模式》(Alexander Shvets, 2022)框架的 22 种 GoF 模式实用指南。涵盖三大任务:
- 选择 —— 将症状转化为候选列表,然后给出一个推荐。
- 实现/重构 —— 在不破坏行为的前提下应用模式。
- 审查/诊断 —— 发现缺失的结构,更常见的是发现过度应用的結構。
该模式目录刻意保持语言中立。将角色和步骤映射到当前代码库的习惯用法上;不要逐字翻译 Java。
移植性
此技能在目录级别是自包含的。仅复制 SKILL.md 文件就足够了。
- 项目本地:
<repo>/.opencode/skills/design-patterns/SKILL.md - 用户全局:
~/.config/opencode/skills/design-patterns/SKILL.md - 兼容位置:
<repo>/.claude/skills/或~/.agents/skills/下的相同结构 - 技能 ID 是目录名 (
design-patterns);前置元数据的name仅作为显示标签。
何时使用此技能
- 一个更改反复波及到不相关的类,或者一个类为每个新情况不断增长分支。
- 对象构造变成了一堆参数、标志或工厂。
- 集成了一个与你接口不匹配的第三方或遗留 API。
- 添加行为组合(压缩 + 加密 + 重试 + 日志记录)会导致子类层次结构爆炸。
- 行为依赖于生命周期:草稿 → 审核 → 已发布,连接中 → 已连接 → 已关闭,待处理 → 已支付 → 已发货。
- 一个更改必须通知一组未知或变化的消费者。
- 操作、撤销、队列化工作或可重放操作需要变成对象。
- 需要在树或对象图上添加遍历、导出或分析。
- 内存压力来自许多几乎相同的对象。
- 审查设计是否存在意大利面条式耦合或推测性抽象。
何时不使用此技能
- 脚本、一次性迁移或原型,其中结构的成本超过其生命周期的价值。
- 添加模式的唯一理由是“最佳实践”、一本书或一个 linter。
- 你无法说出该结构旨在吸收的具体更改。
- 语言直接提供了该行为(迭代器、事件、模式匹配、依赖注入、闭包)。
- 团队无法维护这一层间接性。一个被理解了的简单设计胜过一个未被理解的正确模式。
基本规则
- 模式是一个涌现出來的结构名称,而不是目标。 推荐结构;仅使用模式名称来解释它。
- 应用模式前通过三项测试。 (a) 存在一个具体的力或症状,而非假设性的。 (b) 现在或计划中至少存在两种合理的变体。 (c) 增加的间接性在后续几次更改中能收回成本。
- 优先选择最小可行结构: 内联代码 → 函数 → 参数化函数 → 接口+一个实现 → 接口+多个实现 → 完整模式。
- 审查时,没有证据绝不添加模式。 引用能证明其合理性的重复、分支数量、依赖边或测量成本。
- 按领域命名角色,而不是按模式。
ShippingPolicy优于ShippingStrategy;DocumentPublisher优于DocumentObserverSubject,除非模式本身就是共享词汇。 - 删除旧路径。 如果不制定删除计划就应用模式作为第二条并行路径,这是在制造有额外步骤的技术债务。
- 模式可以组合。 大多数真实设计是一个模式内部包含另一个模式(Composite + Visitor,Command + Memento,Mediator + Observer)。首先选择主要力;让协作者跟随。
0. 首先建立上下文
在回答以下问题之前,不要推荐模式。当代码无法回答这些问题时,请询问。
- 语言与范式。 继承密集型、基于接口的、函数式的还是混合的?它是否具有第一类函数、和类型、模式匹配、生成器、事件、DI?
- 变化轴。 实际变化的是哪个维度:创建、算法、结构、通信、生命周期、存储还是传输?
- 变体数量。 现在存在多少种实现?计划了多少种?(“现在一种,下个季度一种”是合理的答案。)
- 生命周期与所有权。 谁创建、拥有、缓存和销毁对象?是否有组合根或 DI 容器?
- 并发性。 实例是否在多个线程间共享?通知是同步的吗?命令是否排队?
- 持久性与分布。 对象或事件是否需要序列化、版本控制、重试或通过网络发送?
- 性能预算。 是否测量并限制了内存、延迟或分配率?
- 测试策略。 是否可以在没有真实数据库、时钟、文件系统或网络的情况下测试设计?
- 团队惯例。 代码库是否已经使用了模式词汇、框架扩展点或架构边界?
记录下答案。没有这个上下文的推荐只是猜测。
1. 选择模式
1.1 症状 → 候选
| 症状 | 首选候选 | 考虑替代方案 |
|---|---|---|
new 分散在业务逻辑中;类型由配置选择 | 工厂方法 | DI 容器、简单工厂函数 |
| 几个相关产品必须匹配(相同主题、驱动程序、供应商) | 抽象工厂 | 每个产品使用工厂方法、参数化工厂 |
| 构造函数有许多可选参数或标志参数 | 构建器 | 命名/可选参数、记录+验证 |
| 复制对象需要知道其具体类或私有字段 | 原型 | 拷贝构造函数、序列化往返 |
| 一个共享资源需要恰好一个实例和全局访问 | 单例 | 容器范围的单例、模块级实例、显式注入 |
| 第三方/遗留接口不匹配 | 适配器 | 更改你的接口、防腐层 |
| 两个独立的维度使子类数量倍增(形状 × 颜色、设备 × 操作系统) | 桥接 | 拆分为两个参数、组合 |
| 部分-整体树必须被统一处理 | 组合 | 基于数据模型的普通递归函数 |
| 行为组合使子类爆炸(通过邮件+短信+Slack通知) | 装饰器 | 标志、中间件链、策略列表 |
| 客户端淹没在多类子系统中 | 外观 | 窄化模块 API、服务层 |
| 数百万个相似对象耗尽内存 | 享元 | 内部共享、结构体数组、惰性数据 |
| 访问、懒加载、缓存或远程调用必须透明 | 代理 | 显式缓存层、存储库、客户端包装器 |
| 一个请求可以由几个未知顺序的处理程序中的任何一个处理 | 责任链 | 中间件管道、有序函数列表 |
| 动作必须排队、重试、记录、撤消或参数化 | 命令 | 闭包、作业队列负载、事件溯源 |
| 遍历必须统一且独立于表示 | 迭代器 | 语言迭代器/生成器 |
| 许多组件与许多组件通信;可重用的组件无法实现 | 中介者 | 事件总线、应用服务、观察者 |
| 撤消/回滚必须恢复状态而不暴露内部细节 | 备忘录 | 事件日志、数据库事务、写时复制快照 |
| 一个更改必须通知一组动态变化的消费者 | 观察者 | 消息代理、响应式流、信号 |
大的 switch 作用于状态;转换分散在各处 | 状态 | 状态机库、转换表、和类型 |
| 多个算法用于一项任务;在运行时/配置时选择 | 策略 | 函数参数、表查找、多态 |
| 相同的算法骨架,少数步骤变化 | 模板方法 | 策略/组合、高阶函数、钩子 |
| 许多不相关的操作作用于一个稳定的对象结构 | 访问者 | 模式匹配、外部函数、序列化器 |
| 对树进行聚合操作 | 组合 + 访问者 | 递归折叠、查询 API |
1.2 约束过滤器
在应用决胜规则之前先应用这些。它们比任何模式比较都能淘汰更多错误答案。
- 静态与动态变化。 策略、状态、桥接和代理允许运行时替换。模板方法和基于继承的工厂方法在编译时固定行为。
- 一个对象 vs. 一个家族。 工厂方法创建一个产品;抽象工厂创建一个兼容的家族;构建器逐步组装一个复杂产品。
- 包装 vs. 替换 vs. 简化。 装饰器保持接口并添加行为;代理保持接口并控制访问;适配器更改接口;外观在多个对象之上定义一个新的、更简单的接口。
- 推送 vs. 拉取 vs. 路由。 观察者广播给所有订阅者;中介者通过一个协调者路由交互;责任链传递请求直到有人处理。
- 状态 vs. 算法。 状态对象相互了解并触发转换;策略对象是独立的并由客户端选择。
- 结构 vs. 操作。 组合组织对象;访问者在该组织之上添加操作;迭代器提供遍历。
- 内存 vs. CPU。 享元用 CPU 和复杂性换取 RAM;代理缓存用新鲜度和延迟换取重复工作。
- 进程边界。 远程代理、命令序列化和跨进程观察者添加了进程内模式所没有的故障模式(重试、排序、幂等性)。
1.3 正面交锋决胜规则
| 对比对 | 选择前者,当 | 选择后者,当 |
|---|---|---|
| 工厂方法 / 抽象工厂 | 一种产品类型;子类或配置选择具体类 | 几个相关产品必须被创建并保持兼容 |
| 抽象工厂 / 构建器 | 产品作为家族立即返回 | 一个复杂产品逐步组装并在最后返回 |
| 工厂方法 / 构建器 | 变化在于创建哪个类 | 变化在于如何配置一个复杂对象 |
| 构建器 / 原型 | 构造必须逐步验证 | 已经存在一个完全配置的对象并且应该被复制 |
| 适配器 / 桥接 | 事后改造不兼容的代码 | 预先设计两个独立的层次结构 |
| 适配器 / 外观 | 一个接口必须被转换为另一个 | 许多子系统调用必须合并到一个简单的 API 中 |
| 装饰器 / 代理 | 在运行时添加或删除职责;客户端组合包装器 | 控制访问、生命周期、缓存或远程性;代理管理服务 |
| 装饰器 / 责任链 | 每个包装器都运行并添加行为 | 处理程序可能停止链 |
| 组合 / 装饰器 | 目标是具有统一叶子/容器操作的树 | 目标是在节点上添加额外职责,而非聚合 |
| 外观 / 中介者 | 单向简化;子系统不知道外观 | 双向协调;同事知道并调用中介者 |
| 中介者 / 观察者 | 中央协调逻辑和星形拓扑 | 一对多广播,没有中央策略 |
| 策略 / 状态 | 算法是独立的;客户端切换 | 状态触发它们自己的转换并且相互依赖 |
| 策略 / 命令 | 问题是如何执行一个任务 | 问题是执行、存储或撤消什么请求 |
| 策略 / 模板方法 | 行为在运行时通过组合在每个对象上变化 | 行为在编译时通过继承在每个子类上变化 |
| 责任链 / 观察者 | 恰好一个处理程序应该行动 | 所有订阅者都应该被通知 |
| 备忘录 / 命令 | 需求是状态恢复 | 需求是请求封装、排队或重放 |
| 备忘录 / 原型 | 必须保持封装并且需要历史记录 | 简单对象的简单副本就足够了 |
| 迭代器 / 访问者 | 需求是遍历顺序和访问 | 需求是跨许多元素类型的操作 |
| 访问者 / 策略 | 在稳定的元素层次结构上进行许多操作 | 在上下文之上进行一个可互换的算法 |
| 享元 / 单例 | 许多按状态键控的不可变共享实例 | 整个进程正好有一个可变实例 |
| 组合 / 享元 | 层次结构和统一操作很重要 | 共享叶子状态是内存问题 |
1.4 决策树
主要驱动力是什么?
├─ 创建对象
│ ├─ 哪个具体类由子类/配置选择? → 工厂方法
│ ├─ 几个相关产品必须匹配? → 抽象工厂
│ ├─ 一个复杂对象,许多可选部分或步骤? → 构建器
│ └─ 复制一个已有的已配置对象? → 原型
│ └─ 真的需要一个共享实例? → 单例(最后的手段)
├─ 调整或组织结构
│ ├─ 来自你控制之外的接口不兼容? → 适配器
│ ├─ 两个独立的维度使子类数量倍增? → 桥接
│ ├─ 具有统一操作的部分-整体树? → 组合
│ ├─ 在运行时以组合方式添加/删除行为? → 装饰器
│ ├─ 为客户端简化复杂的子系统? → 外观
│ ├─ 内存中太多几乎相同的对象? → 享元
│ └─ 控制访问、生命周期、缓存或远程性? → 代理
└─ 行为和通信
├─ 多个处理程序之一,顺序未知? → 责任链
├─ 请求必须是对象:排队、重试、撤消、重放? → 命令
├─ 遍历而不暴露表示? → 迭代器
├─ 多对多通信需要一个协调者? → 中介者
├─ 恢复先前状态而不破坏封装? → 备忘录
├─ 通知一组动态的订阅者? → 观察者
├─ 行为随生命周期状态变化? → 状态
…
[为翻译而截断]