Trigpoint
Collections 書架 › Software & Systems Architecture 軟體與系統架構 › Don't Repeat Yourself (DRY) 不重複原則
二十年後,兩位作者補了一句:原則講的是知識與意圖。

不重複原則

Don't Repeat Yourself (DRY) · Hunt & Thomas (1999)
書目已核 ✓ 軟體架構 · 設計原則 私下告訴編輯 ▸
三句講透 原則的原文說的是:每一塊知識在系統裡只能有一個明確而權威的表述。
它管的是知識與意圖,不是字面。
所以兩段完全不同的文字可能違反它,而兩段逐字相同的文字可能完全沒問題。

↳ 見過反例?

成立條件
同一條業務規則寫在兩處以上,改了一處就得記得改其他幾處時。
證據強度
規範主張;書目已核
失效樣貌
引用的成本高於重複時,收斂只多一層間接;那一處若本身有錯,錯會更一致、更難發現。
不重複原則 Hunt & Thomas (1999, 2019) Don't Repeat Yourself (DRY) 該收成一處的,是意圖相同的那幾份 縱軸:背後的意圖 橫軸:字面 同一塊知識,寫法不同 同一條判準散在規格、指示、說明裡 字面看不出重複,改的時候會漏 這格才是原則要治的 同一塊知識,寫法也相同 最容易看見的一種重複 收成一處、他處引用即可 處理起來最不費力 不同的知識,寫法也不同 兩件事各自獨立 沒有問題,不需動作 不同的知識,寫法恰好相同 今天一樣是巧合,明天其中一條要改 合併它們=把巧合當成結構 最常見的誤用落在這格 相同 不同 不同 相同 判斷落哪一格只需一問:這兩處之所以存在,是為了同一個意圖嗎。 圖:trigpoint.pub
圖 1 · 兩個軸分開看的四種情形:橫軸是兩段東西的字面是否相同,縱軸是它們背後的意圖是否相同。
原則要治的只有左上那一格;右下那一格是最常見的誤用,把字面相同而意圖不同的東西硬合成一個。
象限為概念示意,不含比例、面積或任何量測數字。 放大看圖 ▸

一、發生什麼事

這條原則寫下二十年後,兩位作者在新版裡回頭替它補了一句說明。1999 年初版《The Pragmatic Programmer》把這條原則寫成一句話:系統內的每一塊知識,必須有單一、無歧義、權威的表述[1]Hunt, A. & Thomas, D. (1999). The Pragmatic Programmer: From Journeyman to Master. Addison-Wesley. Chapter 2, The Evils of Duplication; Tip 11. 書目經官方記錄核對。第 11 條提示的編號與定義句依多源一致轉述。原文定義:every piece of knowledge must have a single, unambiguous, authoritative representation within a system. 該節題為 The Evils of Duplication。。書裡放它的那一節叫「重複之惡」。二十週年版把病症講得很直白:同一件事寫在兩處以上,改了一處就得記得改其他幾處;問題不在你會不會記得,而在你什麼時候忘記[2]Hunt, A. & Thomas, D. (2019). The Pragmatic Programmer: Your Journey to Mastery, 20th Anniversary Edition. Addison-Wesley. Chapter 2, Topic 9; Tip 15. 書目經出版社記錄核對。主張已對照全文核實。作者二十年後的補充:DRY is about the duplication of knowledge, of intent. 同一節並說明,初版沒把這條講清楚,許多人把它理解成只關乎程式碼。。舉個常見的例子:同一條業務規則同時活在資料庫的欄位定義、後端的檢核、前端的表單、以及一份給人看的文件裡。規則改的時候,你要記得改四處。人不會每次都記得,於是系統開始自我矛盾。

二十年後,兩位作者在新版裡補了一句,而這句補充比原句更常被需要:這條原則講的是知識與意圖的重複,是「把同一件事在兩個地方、甚至用兩種完全不同的方式說出來」[2]Hunt, A. & Thomas, D. (2019). The Pragmatic Programmer: Your Journey to Mastery, 20th Anniversary Edition. Addison-Wesley. Chapter 2, Topic 9; Tip 15. 書目經出版社記錄核對。主張已對照全文核實。作者二十年後的補充:DRY is about the duplication of knowledge, of intent. 同一節並說明,初版沒把這條講清楚,許多人把它理解成只關乎程式碼。。他們補這句,是因為初版沒把它講清楚,許多人把它讀成了「不要複製貼上程式碼」[2]Hunt, A. & Thomas, D. (2019). The Pragmatic Programmer: Your Journey to Mastery, 20th Anniversary Edition. Addison-Wesley. Chapter 2, Topic 9; Tip 15. 書目經出版社記錄核對。主張已對照全文核實。作者二十年後的補充:DRY is about the duplication of knowledge, of intent. 同一節並說明,初版沒把這條講清楚,許多人把它理解成只關乎程式碼。。

這兩種讀法會導致相反的行為。照原意,你會去找「同一個判斷散落在幾處」,然後指定一處為準、其餘引用它。照誤讀,你會去找「長得像的兩段文字」,然後把它們合併成一個共用的東西。後者在字面相同而意圖不同的時候會出事:兩段規則今天恰好一樣,明天其中一條因為業務原因要改,而它們已經被綁在一起了。你省下的那次複製,換來一個更難拆的耦合。

二、為什麼這對你重要

把「知識」這個詞換成「判準」,這頁就直接落到你的工作流上。

你手上的判準現在住在幾個地方?一份寫給自己看的規格、一段貼給模型的指示、一份交給協作者的說明、可能還有一個你記在腦裡但沒寫下來的例外。這四份會漂。而它們漂的時候不會報錯:每一份單獨看都合理,只有把它們並排才看得出矛盾,而你平常不會並排。

原意的做法是指定一處為準,其他地方寫「見那一處」。這聽起來像行政手續,實際上是在改變失效的形狀:漂移從「四份各自演化,你不知道哪份對」變成「一份改了,引用它的地方自動跟上」。這筆帳也有算不過來的時候:一塊知識若只用在兩處、兩處又極少改,另設一處讓它們引用,多出來的只是一個要維護的地方。

但誤讀那條路也要防,而且在使用模型的時候更容易踩到。你會很想把三段看起來重複的指示合成一段通用的,因為它們的文字八成相同。停一下,問那個真正的問題:這三段背後是同一個意圖嗎? 如果其中一段之所以存在,是為了處理另外兩段不處理的例外,那它的字面重複是巧合,合併它就等於刪掉那個例外。

實務上這頁只留一句可以直接用的話:先問這是不是同一塊知識,再決定要不要合。反過來做,你會把巧合當成結構。

反例與失效邊界

第一個邊界是這條原則的代價。把散落的知識收成一處,需要一個能被引用的地方,而那個地方本身要被維護。當引用的成本高於重複的成本時(例如那塊知識只用在兩處、且兩處都極少改),硬套原則會製造一層沒人受益的間接。這不是原則錯,是它的適用門檻。

第二個邊界是它與可讀性的張力。收斂之後,讀者要理解一段內容,得先跳到被引用的那處。跳一次可以接受,跳三次就開始比重複更難讀。這條線在哪裡沒有公式,但有一個實用問法:這次收斂讓改動變安全的程度,抵不抵得過讓閱讀變曲折的程度。

第三個是最常被忽略的:這條原則不承諾正確。它承諾的是「改一處即全域生效」。如果那一處本身就是錯的,它會讓錯誤更一致、更難被發現,因為系統不再有兩個版本互相牴觸來提示你。單一權威表述加上錯誤內容,等於一個安靜而徹底的錯。防它的是查核,不是這條原則。

Lab 實測 有實測才寫

本節點暫無實測。

常見誤讀

所屬頁核驗:書目已核 ✓ · 內容最後修訂 2026-11-14

  • 常見轉述「這條原則就是叫你不要有重複的程式碼」:原文治的是知識與意圖的重複,不是字面的重複。作者在二十年後那一版明文再講一次,並承認初版沒把它講清楚,許多人因此以為它只關乎程式碼。 #
  • 常見轉述「這是書裡的第 11 條提示」:1999 年初版是第 11 條提示;2019 年二十週年版把它放在第 9 主題,提示編號改為第 15 條。引用時要一併標版本,否則讀者按編號翻不到。初版定義句所在的頁碼本站不標,因為未能對照原書核實。 #
  • 本頁不把「單一真相來源」這個詞歸給這兩位作者:那是另一條概念線,見本站的單一真相來源概念史頁;兩者相容但不同源,署名要分開記。 #
驗證紀錄

記錄核查深度,不擔保結論為真。

核查經過

本頁的錨在 2026 年 5 月經過一次跨模型深度覆核逐條裁定,屬於該月裁定的一批:第一階段由一個模型做廣度掃描,第二階段換另一個模型回到出處逐條裁,兩份報告皆有落檔。

三項判定折入本頁。第一,核心定義逐字確認在 1999 年初版,並確認在 2019 年版被保留[1]Hunt, A. & Thomas, D. (1999). The Pragmatic Programmer: From Journeyman to Master. Addison-Wesley. Chapter 2, The Evils of Duplication; Tip 11. 書目經官方記錄核對。第 11 條提示的編號與定義句依多源一致轉述。原文定義:every piece of knowledge must have a single, unambiguous, authoritative representation within a system. 該節題為 The Evils of Duplication。[2]Hunt, A. & Thomas, D. (2019). The Pragmatic Programmer: Your Journey to Mastery, 20th Anniversary Edition. Addison-Wesley. Chapter 2, Topic 9; Tip 15. 書目經出版社記錄核對。主張已對照全文核實。作者二十年後的補充:DRY is about the duplication of knowledge, of intent. 同一節並說明,初版沒把這條講清楚,許多人把它理解成只關乎程式碼。。第二,章名「重複之惡」確認;編號的版本差異被指出並更正(初版第 11 條提示;二十週年版為第 9 主題、第 15 條提示)。第三,初版頁碼不予確認[3]初版的第 11 條提示與定義句,見於該版的提示清單;館藏目錄記初版該節起於第 26 頁,但定義句所在的頁碼未對照原書核實,本站因此不標頁。二十週年版把它放在第 9 主題(起於第 30 頁),提示編號改為第 15 條。:線上可得的多筆引用把該節指向約第 26 至 27 頁,但二十週年版的章起於 27 頁而該主題起於 30 頁,兩者不可混用,且定義句所在的頁碼未對照原書核實。判定為需實體書核對,本站因此不標頁。

兩項殘餘要說清楚,第二項是我們自己的治理面缺口。

其一,這是一本業界書而非期刊論文,它的權威來自被廣泛採用與作者身分,不來自審查程序。這一點對本書架多數節點都成立。

其二,這次深度覆核的隔離憑證缺席。我們的規矩是:第二階段必須在一個乾淨、不繼承第一階段脈絡的環境裡跑,而證明這件事的方式是留下一份獨立的第二階段指令檔。本節點所指的這批報告是本庫最早的一批(2026 年 5 月中),該資料夾沒有這份指令檔;2026 年 5 月中之後建立的各批都有,全庫共一百二十五份。兩個模型確實都做了事,這有落檔;但第二個模型是否在乾淨環境裡做,這件事無法從檔案證明。 我們的處置是:驗證章依上游標示不動(方法軸確為兩個模型),限制寫在這裡,並把這個缺口回報給知識庫治理端。不因為它看起來像瑕疵就自行升降等級,也不因為它是舊案就不說。

參考文獻

如何閱讀來源註記 「書目經…核對」指作者、年份、題名與出版項已確認;不代表該來源的主張已被核對。「對照全文核實」指主張已與來源文本本身比對。「依多源一致轉述」指主張建立於多份彼此一致、轉述該來源的資料,而非原文件本身。 定義版本:2026-09-20。

  1. [1] Hunt, A. & Thomas, D. (1999). The Pragmatic Programmer: From Journeyman to Master. Addison-Wesley. ISBN 0-201-61622-X. Chapter 2, Tip 11. ↩
  2. [2] Hunt, A. & Thomas, D. (2019). The Pragmatic Programmer, 20th Anniversary Edition. Addison-Wesley. ISBN 978-0-13-595705-9. Chapter 2, Topic 9. ↩
  3. [3] 編輯註,無外部來源;全文見正文註 [3]。

↳ 引註有誤?

新書架開架時通知我

新書架開架時通知我

開架通知只在新書架開架或閱讀規則變更時寄出。

試行

私下告訴編輯:更正、反例或適用性

提交只供編輯閱讀,處理前不公開;處理後,編輯撰寫的摘要與回應才會刊出。提交毋須註冊,暱稱可留空。

你想提交的是
設定公開名稱後,可選擇以名稱致謝 ▸
不登入,直接匿名提交

登入後可在「我的」頁追蹤處理狀態。你寫的內容會保留。

你已登入:本件會連結到你的帳號,只有你和編輯看得到,方便你在「我的」頁追蹤狀態。原文不會公開。 完整私隱政策 ▸

不連到帳號,改為匿名提交 ▸

不收集電郵。你的原文與暱稱只供編輯閱讀,不會公開;站上只刊載編輯撰寫的摘要。真人驗證由 Cloudflare Turnstile 提供;為限制濫用,系統只保存 IP 的雜湊值,不保存明文 IP。原文保存於我們的雲端服務商,可應要求刪除。 完整私隱政策 ▸