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。原文保存于我们的云端服务商,可应要求删除。 完整私隐政策 ▸