測試驅動開發
TDD 是「紅 → 綠 → 重構」的循環。此技能是讓這個循環產出值得保留的測試的參考:什麼是好的測試、測試該放哪裡、反模式有哪些,以及循環的規則。每個章節在每一次循環中都適用——請在循環開始前及進行中查閱,而非結束後才看。
當探索程式碼庫時,請先閱讀 CONTEXT.md(如果存在),讓測試名稱與介面詞彙匹配專案的領域語言,並尊重你所觸及區域中的 ADR。
什麼是好的測試
測試應透過公開介面驗證行為,而非實作細節。程式碼可以完全改變;但測試不該隨之改變。好的測試讀起來像一份規格書——「使用者可以用有效購物車結帳」精確告訴你存在什麼能力——並且能在重構後存活,因為它不在乎內部結構。
相關範例請參閱 tests.md,模擬指南請參閱 mocking.md。
接縫——測試該放哪裡
接縫是被測試模組展現其介面的地方:你在此觀察行為而無需深入內部。測試應存在於接縫處,永遠不對抗內部實作。
在撰寫測試前,先識別要測試的接縫。如果既有的公開介面是顯而易見的接縫,就說明它並直接進行。如果接縫是新的或不明確,請先與使用者確認。你無法測試所有東西——刻意選擇接縫,才能將測試精力放在關鍵路徑與複雜邏輯上,而非每個邊界案例。
提問:「公開介面是什麼?我們該測試哪些接縫?」
反模式
- 實作耦合——模擬內部協作者、測試私有方法,或透過側通道驗證(查詢資料庫而非使用介面)。徵兆:重構時測試失敗,但行為沒有改變。
- 同義反覆——斷言重新計算預期值的方式與程式碼相同(
expect(add(a, b)).toBe(a + b)、手動以相同方式推導的快照、自己等於自己的常數斷言),因此它必然通過,永遠不可能與程式碼不一致。預期值必須來自獨立的真相來源——已知正確的字面值、實例、或規格。 - 水平切片——先寫所有測試,再寫所有實作。批量測試驗證的是想像中的行為:你測試的是事物的形狀而非使用者面對的行為,測試對真實變更不敏感,而且在理解實作之前就承諾了測試結構。應採用垂直切片——一個測試 → 一個實作 → 重複,每個測試都是一發追蹤彈,回應上一循環教給你的事。
循環的規則
- 紅先於綠。 先寫失敗的測試,然後只寫足夠讓它通過的程式碼。不要預測未來的測試或加入推測性的功能。
- 一次一片。 每次循環只處理一個接縫、一個測試、一個最小實作。
- 綠燈後重構。 改善名稱與結構,同時保持行為不變且測試通過。重構期間不要加入新行為;更廣泛的架構變更應屬於審查階段(參閱
code-review技能)。