10.16

我曾以为，好的代码需要大量详尽的注释，解释它的意图、参数和返回值。直到一次代码审查，一个朋友对我说：“你在用注释解释‘为什么’要这么写，这很好。但更好的代码，是能让它的‘是什么’和‘怎么做’不言自明。最好的工具和规范，不是为了增加约束，而是为了减少不必要的复杂性。 当我们把心力花在写出表意清晰的代码上时，我们不仅减少了对注释的依赖，更从根本上提升了软件的质量。这本身，就是一种最有效的“工程”。