測試驅動開發
哲學
核心原則:測試應透過公開介面驗證行為,而非實作細節。程式碼可以完全改變,但測試不應改變。
好的測試是整合型風格的:它們透過公開 API 執行真實的程式碼路徑。它們描述的是系統「做什麼」,而非「如何做」。好的測試讀起來像一份規格書——「使用者可以使用有效的購物車結帳」準確告訴你系統具備哪項功能。這些測試在重構時仍然有效,因為它們不關心內部結構。
糟糕的測試與實作緊耦合。它們模擬內部協作者、測試私有方法,或透過外部手段驗證(例如直接查詢資料庫,而不是使用介面)。警訊:當你重構時測試失敗,但行為沒有改變。如果你重新命名一個內部函式而測試失敗,那些測試是在測試實作,而非測試行為。
請參閱 tests.md 取得範例,以及 mocking.md 取得模擬指南。
反模式:水平切片
不要先寫所有測試,再寫所有實作。 這就是「水平切片」——將 RED 視為「寫所有測試」,將 GREEN 視為「寫所有程式碼」。
這會產生糟糕的測試:
- 大量編寫的測試測試的是「想像中的」行為,而非「實際的」行為
- 你最終測試的是事物的「形狀」(資料結構、函式簽章),而非使用者面對的行為
- 測試對實際變更不敏感——行為中斷時測試通過,行為正常時測試卻失敗
- 你在理解實作之前就承諾了測試結構
正確的方法:透過曳光彈進行垂直切片。一個測試 → 一個實作 → 重複。每個測試都回應你從上一個循環學到的內容。因為你剛剛寫完程式碼,所以你確切知道哪些行為重要以及如何驗證它。
錯誤(水平):
RED: test1, test2, test3, test4, test5
GREEN: impl1, impl2, impl3, impl4, impl5
正確(垂直):
RED→GREEN: test1→impl1
RED→GREEN: test2→impl2
RED→GREEN: test3→impl3
...
工作流程
1. 規劃
在撰寫任何程式碼之前:
詢問:「公開介面應該長什麼樣子?哪些行為最重要,值得測試?」
你無法測試所有東西。 與使用者確認確切哪些行為最重要。將測試努力集中在關鍵路徑和複雜邏輯上,而非每一個可能的邊界情況。
2. 曳光彈
撰寫一個測試,確認系統的「一個」面向:
RED: 為第一個行為撰寫測試 → 測試失敗
GREEN: 撰寫最少程式碼通過測試 → 測試通過
這就是你的曳光彈——證明路徑可以端到端運作。
3. 增量循環
對於其餘每個行為:
RED: 撰寫下一個測試 → 失敗
GREEN: 撰寫最少程式碼通過測試 → 通過
規則:
- 一次一個測試
- 只寫足以通過當前測試的程式碼
- 不要預先猜測未來的測試
- 保持測試專注於可觀察的行為
4. 重構
在所有測試通過之後,尋找重構候選項目:
- 提取重複程式碼
- 深化模組(將複雜性隱藏在簡單介面之後)
- 在自然的情況下套用 SOLID 原則
- 考慮新程式碼對既有程式碼的啟示
- 每一步重構後執行測試
絕不要在 RED 狀態下重構。 先達到 GREEN。
每個循環的檢查清單
[ ] 測試描述的是行為,而非實作
[ ] 測試僅使用公開介面
[ ] 測試在內部重構時仍然有效
[ ] 程式碼是為此測試而寫的最少程式碼
[ ] 沒有新增推測性功能