設計模式 (Design Patterns) 是做什麼的?
一份實用的 22 種 GoF(Gang of Four)模式指南,以《深入淺出設計模式》(Alexander Shvets, 2022)為框架。涵蓋三項任務:
- 選擇 — 將一個症狀轉化為一個候選清單,然後提出單一建議。
- 實作 / 重構 — 在不破壞行為的前提下套用模式。
- 審查 / 診斷 — 找出缺少的結構,以及更常見的:過度套用的結構。
這個目錄刻意保持語言中立。將角色和步驟映射到你面前程式碼庫的習慣用法;不要直接照搬 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。
- 以組合方式(壓縮 + 加密 + 重試 + 日誌)加入行為,這將會導致子類別層級爆炸。
- 行為依賴於生命週期:草稿 → 審查 → 已發布,連線中 → 已連線 → 已關閉,待處理 → 已付款 → 已出貨。
- 一個變更必須通知一個未知或變動中的消費者集合。
- 操作、復原、排隊工作或可重播的動作需要變成物件。
- 需要在樹狀或物件圖上加入走訪、匯出或分析功能。
- 記憶體壓力來自於許多幾乎相同的物件。
- 審查設計是否遭遇義大利麵式耦合或投機式抽象。
何時不該使用此技能
- 指令碼、一次性遷移或原型,其中結構的成本超過了其生命週期。
- 加入模式的唯一理由是「最佳實踐」、一本書或一個 lint 工具。
- 你無法說出具體的變更是該結構預期要吸收的。
- 該語言已經直接提供了該行為(迭代器、事件、模式匹配、依賴注入、閉包)。
- 團隊無法維護這種間接性。一個能被理解的較簡單設計,勝過一個正確但無人理解的模式。
基本規則
- 模式是對已浮現結構的命名,而非目標。 推薦該結構;僅在解釋時使用模式名稱。
- 套用模式前進行三項測試。 (a) 存在具體的當下力量或症狀,而非假設性的。 (b) 現在或預計至少存在兩個合理的變體。 (c) 所增加的間接性在接下來幾次變更內就能回本。
- 優先選擇能工作的最小結構: 內聯程式碼 → 函式 → 參數化函式 → 介面 + 一個實作 → 介面 + 多個實作 → 完整模式。
- 審查時切勿在沒有證據的情況下加入模式。 引用證明了其合理性的重複、分支數量、依賴邊緣或量測到的成本。
- 以領域名稱命名角色,而非模式名稱。
ShippingPolicy 優於 ShippingStrategy;DocumentPublisher 優於 DocumentObserverSubject,除非模式本身是共通的詞彙。
- 刪除舊的路徑。 作為第二條平行路徑套用模式,卻沒有移除計劃,這只是繞了一圈的技術債。
- 模式可組合。 大多數真實設計都是一個模式內部包含另一個模式(Composite + Visitor, Command + Memento, Mediator + Observer)。先選擇主要力量;讓協作者跟隨。
0. 首先建立上下文
在回答這些問題之前,不要推薦任何模式。當程式碼無法回答它們時,請提問。
- 語言與範式。 繼承密集型、基於介面、函數式或混合型?是否擁有一級函式、和類型、模式匹配、生成器、事件、DI?
- 變更軸。 實際變化的是哪個維度:建立、演算法、結構、通訊、生命週期、儲存或傳輸?
- 變體數量。 今天存在多少個實作?預計有多少個?(「現在一個,下個季度一個」是合理的答案。)
- 生命週期與所有權。 誰來建立、擁有、快取和處置物件?是否有組合根或 DI 容器?
- 並發。 實例是否跨執行緒共享?通知是否同步?指令是否排隊?
- 持久性與分佈。 物件或事件是否必須序列化、版本化、重試或透過網路發送?
- 效能預算。 記憶體、延遲或分配率是否已被量測和限制?
- 測試策略。 能否在沒有真實資料庫、時鐘、檔案系統或網路的情況下測試設計?
- 團隊慣例。 程式碼庫是否已使用模式詞彙、框架擴展點或架構邊界?
記錄答案。沒有此上下文的建議只是猜測。
1. 選擇模式
1.1 症狀 → 候選
| 症狀 | 首要候選 | 考慮替代方案 |
|---|
new 散落在業務邏輯中;由配置決定類型 | Factory Method | DI 容器、簡單工廠函式 |
| 多個相關產品必須匹配(相同主題、驅動程式、供應商) | Abstract Factory | 每個產品使用 Factory Method、參數化工廠 |
| 建構子有許多可選參數或旗標引數 | Builder | 具名/可選參數、record + 驗證 |
| 複製物件需要知道其具體類別或私有欄位 | Prototype | 複製建構子、序列化往返 |
| 一個共享資源需要恰好一個實例和全域存取 | Singleton | 容器範圍的 singleton、模組層級實例、顯式注入 |
| 第三方/舊有介面不匹配 | Adapter | 變更你的介面、防腐層 |
| 兩個獨立維度造成子類別倍增(形狀 × 顏色、裝置 × OS) | Bridge | 拆分為兩個參數、組合 |
| 部分-整體樹必須被統一處理 | Composite | 對資料模型進行單純的遞迴函式 |
| 行為組合導致子類別爆炸(透過 email + SMS + Slack 通知) | Decorator | 旗標、中介軟體鏈、策略清單 |
| 用戶端淹沒在一個多類別子系統中 | Facade | 縮小模組 API、服務層 |
| 數百萬個相似物件耗盡記憶體 | Flyweight | 實習、結構體陣列、惰性資料 |
| 存取、惰性載入、快取或遠端呼叫必須是透明的 | Proxy | 顯式快取層、儲存庫、用戶端包裝器 |
| 一個請求可能由數個處理者之一處理,順序未知 | Chain of Responsibility | 中介軟體管線、有序函式清單 |
| 動作必須排隊、重試、記錄、復原或參數化 | Command | 閉包、工作佇列負載、事件溯源 |
| 走訪必須是統一且獨立於表示的 | Iterator | 語言迭代器/生成器 |
| 許多元件與許多元件通訊;無法實現可重用元件 | Mediator | 事件匯流排、應用服務、Observer |
| 復原/回滾必須在不暴露內部結構的情況下恢復狀態 | Memento | 事件日誌、資料庫交易、寫入時複製快照 |
| 一個變更必須通知動態的消費者集合 | Observer | 訊息代理、反應式串流、訊號 |
大型 switch 判斷狀態;轉換散落各處 | State | 狀態機函式庫、轉換表、和類型 |
| 一項任務有多種演算法;在執行時期/配置時選擇 | Strategy | 函式參數、表格查詢、多型 |
| 相同演算法骨架,少數步驟不同 | Template Method | Strategy/組合、高階函式、鉤子 |
| 對穩定的物件結構進行許多不相關的操作 | Visitor | 模式匹配、外部函式、序列化器 |
| 對樹進行聚合操作 | Composite + Visitor | 遞迴摺疊、查詢 API |
1.2 限制條件過濾器
在決勝局之前套用這些。它們能消除的模式錯誤選擇比任何模式比較都多。
- 靜態 vs 動態變更。 Strategy, State, Bridge 和 Proxy 允許執行時期替換。Template Method 和基於繼承的 Factory Method 在編譯時期固定行為。
- 單一物件 vs 一組物件。 Factory Method 建立一個產品;Abstract Factory 建立一個相容的產品族;Builder 逐步組裝一個複雜產品。
- 包裝 vs 替換 vs 簡化。 Decorator 保留介面並增加行為;Proxy 保留介面並控制存取;Adapter 變更介面;Facade 定義一個新的、更簡單的介面來封裝多個物件。
- 推送 vs 拉取 vs 路由。 Observer 廣播給所有訂閱者;Mediator 透過一個協調者路由互動;Chain of Responsibility 傳遞請求直到有人處理。
- 狀態 vs 演算法。 State 物件彼此認識並觸發轉換;Strategy 物件是獨立的,由客戶端選擇。
- 結構 vs 操作。 Composite 組織物件;Visitor 在該組織之上增加操作;Iterator 提供走訪方式。
- 記憶體 vs CPU。 Flyweight 以 CPU 和複雜性換取 RAM;Proxy 快取以新鮮度和延遲換取重複工作。
- 處理邊界。 遠端 Proxy、Command 序列化和跨程序的 Observer 會增加錯誤模式(重試、排序、冪等性),而進程內模式則沒有。
1.3 對比決勝局
| 配對 | 選擇前者當 | 選擇後者當 |
|---|
| Factory Method / Abstract Factory | 單一產品類型;子類別或配置選擇具體類別 | 必須建立多個相關產品並保持相容 |
| Abstract Factory / Builder | 產品立即作為一個產品族返回 | 一個複雜產品逐步組裝並在最後返回 |
| Factory Method / Builder | 變化在於 建立哪個類別 | 變化在於 如何配置一個複雜物件 |
| Builder / Prototype | 建構必須逐步驗證 | 一個完全配置的物件已存在,應該被複製 |
| Adapter / Bridge | 事後改造不相容的程式碼 | 預先設計兩個獨立的層次結構 |
| Adapter / Facade | 必須將一個介面轉換為另一個 | 許多子系統呼叫必須被折疊成一個簡單的 API |
| Decorator / Proxy | 在執行時增加或移除責任;客戶端組合包裝器 | 控制存取、生命週期、快取或遠端;代理管理服務 |
| Decorator / Chain of Responsibility | 每個包裝器都執行並增加行為 | 處理者可能停止鏈 |
| Composite / Decorator | 目標是帶有統一葉/容器操作的樹 | 目標是節點上的額外責任,而非聚合 |
| Facade / Mediator | 單向簡化;子系統不知道外觀 | 雙向協調;同事知道並呼叫中介者 |
| Mediator / Observer | 集中協調邏輯和星狀拓撲 | 一對多廣播,無集中策略 |
| Strategy / State | 演算法是獨立的;客戶端切換 | 狀態觸發它們自己的轉換並彼此依賴 |
| Strategy / Command | 問題是 如何 執行一個任務 | 問題是 什麼 請求要執行、儲存或復原 |
| Strategy / Template Method | 行為透過組合在執行時因物件而異 | 行為透過繼承在編譯時因子類別而異 |
| Chain of Responsibility / Observer | 恰好一個處理者應該動作 | 所有訂閱者都應被通知 |
| Memento / Command | 需求是狀態恢復 | 需求是請求封裝、排隊或重播 |
| Memento / Prototype | 必須保留封裝性且需要歷史記錄 | 簡單物件的簡單複本就足夠 |
| Iterator / Visitor | 需求是走訪順序和存取 | 需求是跨越多個元素類型的操作 |
| Visitor / Strategy | 在穩定的元素層次結構上的許多操作 | 一個在上下文上可互換的演算法 |
| Flyweight / Singleton | 許多由狀態鍵控的不可變共享實例 | 整個進程只有一個可變實例 |
| Composite / Flyweight | 層次結構和統一操作很重要 | 共享葉節點狀態是記憶體問題 |
1.4 決策樹
主要力量是什麼?
├─ 建立物件
│ ├─ 哪個具體類別由子類別/配置選擇? → Factory Method
│ ├─ 多個相關產品必須匹配? → Abstract Factory
│ ├─ 一個複雜物件,多個可選部分或步驟? → Builder
│ └─ 複製一個現有已配置的物件? → Prototype
│ └─ 真正只有一個共享實例? → Singleton(最後手段)
├─ 適配或組織結構
│ ├─ 來自你控制範圍外的不相容介面? → Adapter
│ ├─ 兩個獨立維度導致子類別倍增? → Bridge
│ ├─ 具有統一操作的部分-整體樹? → Composite
│ ├─ 在執行時以組合方式增加/移除行為? → Decorator
│ ├─ 為客戶端簡化複雜的子系統? → Facade
│ ├─ 記憶體中有太多近乎相同的物件? → Flyweight
│ └─ 控制存取、生命週期、快取或遠端? → Proxy
└─ 行為與通訊
├─ 數個處理者之一,順序未知? → Chain of Responsibility
├─ 請求必須是物件:排隊、重試、復原、重播? → Command
├─ 走訪而不暴露表示? → Iterator
├─ 多對多通訊需要協調者? → Mediator
├─ 在不破壞封裝的情況下恢復先前狀態? → Memento
├─ 通知動態的訂閱者集合? → Observer
├─ 行為隨生命週期狀態而改變? → State
├─ 多個可互換的演算法? → Strategy
├─ 演算法骨架固定,部分步驟可變? → Template Method
└─ 對穩定的物件結構進行許多不相關的操作? → Visitor
2. 實作或重構為模式
2.1 安全套用規則
- 單步執行。 一次抽取一個角色、一個職責或一個參考。每次變更後執行測試。
- 先內化再抽取。 從阻塞測試通過開始。然後抽取介面、參數,最後是角色物件。
- 偏好轉接器而非修改。 當你無法更改目標時,Adapter 模式更好。實作一個新的介面,並將原始物件作為依賴項傳入。
- 注入工廠。 不要讓一個類別直接直接
new 一個可設定行為。透過建構子或設定器注入工廠、策略或狀態。
- 單向參考。 子節點不應持有父節點的參考。觀察者不應持有主題的參考。如果需要,請求它。
2.2 重構常見的「非模式」
| 你看到的 | 可能是 | 重構為 |
|---|
if type == "A" 在整個類別中 | 遺失的 Factory Method | 一個 create 方法和具體的建立者子類別 |
| 建構子中有 8 個以上參數,多數為可選 | 遺失的 Builder | Builder 類別,帶有逐步建構方法 |
switch (state) 在每個方法中 | 遺失的 State | 每個狀態一個類別,委派呼叫 |
if (condition) doA else doB 且條件從外部設定 | 遺失的 Strategy | Strategy 介面,建立時注入 |
類別同時實作 drawCircle、drawSquare、drawTriangle | 遺失的 Visitor | 接受一個 Visitor 介面並讓每個訪問者實作形狀 |
List<Handler> 且一個 for 迴圈呼叫全部 | Chain 換成了 Observer | 決定:一個處理者停止嗎?(Chain)還是全部處理?(Observer) |
class Logger extends Compressor extends Encryptor extends Retrier | 遺失的 Decorator | 一個包裝器的建構子接受一個 Component |
CustomerRepository 全是靜態方法,對資料庫進行直接 SQL 查詢 | 過早的最佳化 | 注入資料來源;讓儲存庫實作一個介面 |
一個 ShapeFactory 使用 if type 返回 Circle、Square、Triangle | 完全可以;這是一個簡單工廠 | 僅當新形狀意味著修改工廠時才需要 Factory Method |
2.3 組合:常見場景
| 訂單 | 圖案 | 常見用途 |
|---|
| Composite 包含 Visitor | 走訪樹以進行匯出、驗證、渲染 | |
| Command 包含 Memento | 可復原的操作(編輯器、交易) | |
| Mediator 包含 Observer | 協調者監聽元件;元件不互相認識 | |
| Chain of Responsibility 包含 Command | 中介軟體管線將請求包裝為可重試的工作 | |
| Facade 後方有 Abstract Factory | 外觀建立不同的產品族(測試 vs 正式環境) | |
| Bridge 兩端都有 Strategy | 平台抽象化,兩端交換演算法 | |
3. 審查與診斷
3.1 缺少模式
掃描程式碼庫尋找上述的「非模式」表格。尋找:
- 類別因 type 欄位而膨脹。 → 建議使用 Factory Method、Strategy 或 State。
- 建構子參數超過 6 個。 → 檢查是否可以萃取一個 Builder 或參數物件。
if/else 或 switch 鏈比語言基準長。 → 部分可能變成 Strategy 或 State。
- 一個類別超過 3 個「職責」關鍵字(連線、驗證、記錄、重試)。 → Decorator 或 Chain of Responsibility。
- 難以測試的靜態方法或 Singleton。 → 注入一個介面。
- 樹狀走訪與業務邏輯混合。 → Visitor 或 Iterator。
3.2 過度套用的模式(更常見!)
| 證據 | 可能發生什麼 | 建議 |
|---|
| 一個介面,一個實作,且第二個實作從未被排程 | 投機式介面 | 合併;僅在使用點注入 |
AbstractFactory 建立一個在程式碼中各處都成對使用的單一產品 | 抽象過多 | 替換為 Factory Method 或一個簡單工廠函式 |
Visitor 包含一個方法的 switch,但元素類別從未增加 | 不必要的 Visitor | 使用多型方法或在元素上使用模式匹配 |
Observer 附加了一個回呼,該回呼是在同一個類別中處理的 | 回呼 | 像一個 lambda 一樣呼叫它 |
Singleton 的多個實例(同一程式碼庫中) | 模式誤用 | 為每個用途注入一個不同的範圍 |
Decorator 鏈未用於組合;所有包裝器都在每個請求上執行 | 過度工程化的清單 | 使用一個列表並迭代它,或僅內聯 |
Proxy 除了委派之外不做任何事 | 沒有代理行為 | 刪除;直接使用服務 |
Command 物件被建立但從未排隊、記錄或復原 | 不必要的封裝 | 直接呼叫方法,除非你需要佇列 |
3.3 審查的 5 分鐘檢查清單
4. 模式目錄
每種模式都是一個表格:
| 部分 | 內容 |
|---|
| 意圖 | 一句話說明。 |
| 適用於 | 症狀和力量。 |
| 結構 | 類別/角色。 |
| 建議實作 | 語言中立;使用你語言中的對應機制。 |
| 範例 | 當前程式碼庫中的具體範例(AI 填入)。 |
| 與…比較 | 最接近的替代方案的連結。 |
4.1 建立型模式(5 種)
| 模式 | 意圖 |
|---|
| Factory Method | 定義一個用於建立物件的介面,但讓子類別決定要實例化哪個類別。 |
| Abstract Factory | 提供一個用於建立相關或依賴物件家族的介面,而無需指定它們的具體類別。 |
| Builder | 將一個複雜物件的建構與其表示分離,使相同的建構過程可以建立不同的表示。 |
| Prototype | 指定使用原型實例來建立的物件種類,並透過複製這個原型來建立新的物件。 |
| Singleton | 確保一個類別只有一個實例,並提供一個全域存取點。 |
4.2 結構型模式(7 種)
| 模式 | 意圖 |
|---|
| Adapter | 將一個類別的介面轉換為客戶端期望的另一個介面。 |
| Bridge | 將抽象部分與其實作部分分離,使它們可以獨立地變化。 |
| Composite | 將物件組合成樹狀結構以表示部分-整體層次結構。 |
| Decorator | 動態地為一個物件附加額外的職責。 |
| Facade | 為子系統中的一組介面提供一個統一的簡化介面。 |
| Flyweight | 透過共享來有效地支援大量細粒度的物件。 |
| Proxy | 為另一個物件提供一個代理或佔位符以控制對它的存取。 |
4.3 行為型模式(10 種)
| 模式 | 意圖 |
|---|
| Chain of Responsibility | 透過給予多個物件處理請求的機會,來避免請求的發送者與接收者之間的耦合。 |
| Command | 將一個請求封裝為一個物件,從而允許你使用不同的請求、佇列或記錄請求來參數化客戶端。 |
| Iterator | 提供一種方法順序存取一個聚合物件中的各個元素,而又不暴露其底層表示。 |
| Mediator | 定義一個封裝一組物件如何互動的物件。 |
| Memento | 在不違反封裝的情況下捕獲並外部化一個物件的內部狀態,以便稍後可以將物件恢復到此狀態。 |
| Observer | 定義物件之間的一對多依賴關係,以便當一個物件改變狀態時,所有依賴它的物件都會被自動通知和更新。 |
| State | 允許一個物件在其內部狀態改變時改變其行為。 |
| Strategy | 定義一系列演算法,將每個演算法封裝起來,並使它們可以互換。 |
| Template Method | 在一個方法中定義一個演算法的骨架,並將一些步驟延遲到子類別中。 |
| Visitor | 表示一個作用於一個物件結構中各個元素的操作。 |