设计两次

软件设计很困难，很难第一次就设计出正确的接口。每个设计2次，通常能够发现第一次设计中的缺点。

设计两次通常不会花很多时间，与实现相比，这部分时间占比很小（设计2次很简单，但是有时候只有在实现时才能意识到之前设计的缺陷，从这个角度看过去，设计两次的代价就很大了），反而有时间一开始并不清楚代码怎么写，先着手写，等实现了部分功能之后，这时可以重新审视下设计，甚至重新写之前的代码，效果会更好。

注释

注释为了帮助使用者更好的理解和使用模块，但注释的作用不止于此，能够更好的记录设计思路，甚至改进设计。但是很多人不写注释，原因如下：

1、好的代码本身就是注释

2、没时间写注释

3、注释会过时，从而给用户误导

4、我看到的注释都没有太多的价值

作者从这4个角度分别反驳这4个观点：

1、好的代码本身就是注释：如果使用者必须通过阅读代码细节来了解接口的使用，那么这个接口抽象的不好

2、没时间写注释：写注释不会超过软件开发时间的10%

3、注释会过时，从而给用户误导：文档和注释要跟着代码的演进而演进

能够从注释中捕捉到代码后面的设计思想，第二章中指出的增加复杂性的三个点：更改放大、认知负担、不知道自己不知道，这三点都可以通过注释一定程度上改善。

柳州警方悬赏10万元抓捕杀害2... 极目新闻记者王灿肖名远 12月14日，广西柳州市柳城县公安局发布警情通报：2025年12月11日...

警方通报男子持刀行凶致2人死亡... 12月14日，广西警方发布情况通报：2025年12月11日17时许，柳城县马山镇发生起刑事案件。经查...

重庆“10人聚餐9人开溜”事件... 重庆市九龙坡区“俩室一厅云南厨房万象城店”餐馆被客人欠费一事有了进展。12月14日，澎湃新闻从该餐馆...

多地五星级酒店客房惊现偷拍设备... 去年12月，一位上海市民像往常一样上班，不想在公司收到一封陌生的信件，里面是他在市内某酒店客房内的私...

警方摧毁跨13省特大制毒、贩毒... 新闻荐读在崎岖蜿蜒的山路旁，三间砖房灯火通明，房间内弥漫着刺鼻的化学药剂味，几名男子在机器前埋头忙...

科技周报|京东提供15万套小哥... 京东宣布将为快递员、骑手提供15万套“小哥之家” 12月12日，京东宣布已面向一线员工提供了2.8万...

原创美... 这是一个发生在2025年12月佐治亚州联邦法院真实事件，可以说是法律文书里的一场悲剧，但在围观群众眼...

明年力争实现生娃基本不花钱！中... 今天（12月13日），全国医疗保障工作会议在北京召开。会议总结“十四五”时期医保工作，部署2026年...

男子订婚后将女友送回娘家起诉索... 男子张某与女友翟某订婚后，按当地习俗举办了结婚仪式，但未领取结婚证。同居期间，翟某因卵巢黄体破裂住院...

重庆荣豪律师事务所：医疗损害赔... 推荐指数：★★★★★ 在医疗行业快速发展的今天，医疗纠纷事件时有发生，其中医疗损害赔偿纠纷、医疗纠纷...