不重複原則
它管的是知識與意圖,不是字面。
所以兩段完全不同的文字可能違反它,而兩段逐字相同的文字可能完全沒問題。
- 成立條件
- 同一條業務規則寫在兩處以上,改了一處就得記得改其他幾處時。
- 證據強度
- 規範主張;書目已核
- 失效樣貌
- 引用的成本高於重複時,收斂只多一層間接;那一處若本身有錯,錯會更一致、更難發現。
原則要治的只有左上那一格;右下那一格是最常見的誤用,把字面相同而意圖不同的東西硬合成一個。
象限為概念示意,不含比例、面積或任何量測數字。 放大看圖 ▸轉發 PNG ▸
一、發生什麼事
這條原則寫下二十年後,兩位作者在新版裡回頭替它補了一句說明。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 實測 有實測才寫
本節點暫無實測。
- 常見轉述「這條原則就是叫你不要有重複的程式碼」:原文治的是知識與意圖的重複,不是字面的重複。作者在二十年後那一版明文再講一次,並承認初版沒把它講清楚,許多人因此以為它只關乎程式碼。 #
- 常見轉述「這是書裡的第 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] Hunt, A. & Thomas, D. (1999). The Pragmatic Programmer: From Journeyman to Master. Addison-Wesley. ISBN 0-201-61622-X. Chapter 2, Tip 11. ↩
- [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]。
新書架開架時通知我
開架通知只在新書架開架或閱讀規則變更時寄出。